MCP Server
Query the DERO blockchain from AI assistants — no middlemen, no API keys, no surveillance.
The DERO MCP server implements the Model Context Protocol (opens in a new tab), an open standard for connecting AI models to external tools. Run it locally, point it at your own node, and let your AI assistant interact with DERO directly.
Why This Matters
AI assistants are powerful research tools, but most blockchain integrations route through centralized APIs that log your queries. This server runs on your machine, talks to your node (or a public one you choose), and communicates with your AI over local stdio. No accounts. No tracking. Just code you can audit.
Install
npm install -g dero-mcp-serverRequires Node.js 18+. Source code: github.com/DHEBP/dero-mcp-server (opens in a new tab)
Run Your Own Node
The server defaults to a third-party public RPC. For real privacy, run your own daemon:
# Start your local DERO daemon with RPC enabled
./derod --rpc-bind=127.0.0.1:10102Then configure the MCP server to use it (see below).
Configure Your MCP Client
Claude Desktop
Edit claude_desktop_config.json:
| OS | Path |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/claude/claude_desktop_config.json |
{
"mcpServers": {
"dero": {
"command": "dero-mcp-server",
"env": {
"DERO_DAEMON_URL": "http://127.0.0.1:10102"
}
}
}
}Omit env to use the default public RPC.
Cursor
Settings → MCP → Add Server
- Command:
dero-mcp-server - Environment:
DERO_DAEMON_URL=http://127.0.0.1:10102(optional)
OpenCode
opencode mcp add dero -- dero-mcp-serverOr with a local node:
opencode mcp add dero -e DERO_DAEMON_URL=http://127.0.0.1:10102 -- dero-mcp-serverContinue / Cline / Zed / Others
Any MCP-compatible client works. The server uses stdio transport:
command: dero-mcp-server
env: DERO_DAEMON_URL=http://127.0.0.1:10102 (optional)Consult your client's MCP documentation for the exact config format.
What You Can Ask
Once connected, talk to your AI naturally:
- "What's the current DERO block height?"
- "Show me the source code for contract
[SCID]" - "What variables does this smart contract store?"
- "Look up the transaction
[TXID]" - "What's the network hashrate and difficulty?"
- "Resolve the name
deroto a wallet address"
Available Tools
| Tool | RPC Method | Description |
|---|---|---|
dero_daemon_ping | DERO.Ping | Check daemon connectivity |
dero_get_info | DERO.GetInfo | Network height, difficulty, version, hashrate |
dero_get_height | DERO.GetHeight | Current height, stable height, topoheight |
dero_get_block | DERO.GetBlock | Full block by hash or height |
dero_get_block_header_by_hash | DERO.GetBlockHeaderByHash | Block header by hash |
dero_get_block_header_by_topoheight | DERO.GetBlockHeaderByTopoHeight | Block header by topoheight |
dero_get_block_template | DERO.GetBlockTemplate | Mining block template |
dero_get_tx | DERO.GetTransaction | Transaction details by hash |
dero_get_sc | DERO.GetSC | Smart contract code and state variables |
dero_get_gas_estimate | DERO.GetGasEstimate | Estimate gas for a contract call |
dero_get_random_address | DERO.GetRandomAddress | Random registered wallet addresses |
dero_name_to_address | DERO.NameToAddress | Resolve registered name → address |
dero_get_encrypted_balance | DERO.GetEncryptedBalance | Encrypted balance for an address |
Security Model
Read-only by design. This server cannot:
- Send transactions
- Transfer funds
- Invoke smart contracts
- Submit blocks
- Access your wallet
Wallet RPC methods (transfer, scinvoke, etc.) are explicitly excluded. The server only queries public blockchain data through daemon RPC.
If you need write capabilities in the future, they will be gated behind explicit flags and a separate wallet URL — never enabled by default.
Environment
| Variable | Default | Description |
|---|---|---|
DERO_DAEMON_URL | http://82.65.143.182:10102 | Daemon base URL. Set to http://127.0.0.1:10102 for a local node. |
Verify, Don't Trust
- Source code on GitHub (opens in a new tab)
- Package on npm (opens in a new tab)
- MIT licensed — fork it, audit it, improve it
See Also
- DERO Daemon RPC API — full RPC reference
- Running a DERO Node — set up your own daemon
- XSWD — browser wallet integration