What can you do with this server?

This server provides read-only access to a DERO Stargate blockchain daemon via MCP, enabling blockchain data retrieval, smart contract inspection, and network analysis. It does not support wallet calls, transaction submission, or block submission by design. * Connectivity & Diagnostics: Ping the daemon and echo strings through it to verify connectivity. * Chain Info: Retrieve height, difficulty, version, mempool size, and total block count. * Block Data: Fetch the latest block header, full blocks by height or hash, and block headers by topological height or hash. * Transaction Data: List pending mempool transactions and fetch full transaction details by hash. * Address & Balance: Get random registered addresses for ring signature construction, retrieve encrypted balance blobs for an address, and resolve on-chain names to addresses. * Smart Contracts: Read smart contract source code and stored variables by SCID; estimate gas costs for deployments, calls, or transfers. * Mining: Retrieve a block template for a given miner address (no block submission).

This server provides read-only access to a DERO Stargate blockchain daemon via MCP, enabling blockchain data retrieval, smart contract inspection, and network analysis. It does not support wallet calls, transaction submission, or block submission by design.

Connectivity & Diagnostics: Ping the daemon and echo strings through it to verify connectivity.
Chain Info: Retrieve height, difficulty, version, mempool size, and total block count.
Block Data: Fetch the latest block header, full blocks by height or hash, and block headers by topological height or hash.
Transaction Data: List pending mempool transactions and fetch full transaction details by hash.
Address & Balance: Get random registered addresses for ring signature construction, retrieve encrypted balance blobs for an address, and resolve on-chain names to addresses.
Smart Contracts: Read smart contract source code and stored variables by SCID; estimate gas costs for deployments, calls, or transfers.
Mining: Retrieve a block template for a given miner address (no block submission).

DERO MCP server

dero-mcp-server MCP server

Model Context Protocol (MCP) server that exposes read-only and analysis calls against a DERO Stargate daemon JSON-RPC endpoint. Use it from Claude Desktop, Cursor, or any MCP client that launches a local process over stdio.

What it does

Connects to {DERO_DAEMON_URL}/json_rpc (default http://82.65.143.182:10102).
Registers one MCP tool per common daemon method (DERO.GetInfo, DERO.GetHeight, DERO.GetSC, etc.).
Returns JSON results as MCP text content.

Not included (by design in v0.1): wallet RPC (transfer, scinvoke), DERO.SendRawTransaction, DERO.SubmitBlock. Those can move funds or consensus data; add them only with explicit user consent and a locked-down setup.

Requirements

Node.js 18+
A reachable DERO daemon with RPC enabled (local node or your own remote URL).

Install & build

cd dero-mcp-server
npm install
npm run build

Run (same default RPC as below if DERO_DAEMON_URL is unset):

node dist/index.js

Or set an explicit URL (e.g. your local daemon):

DERO_DAEMON_URL=http://127.0.0.1:10102 node dist/index.js

The baked-in default is a third-party public RPC (82.65.143.182:10102) — prefer your own node when you run one.

Strip a trailing /json_rpc if you paste a full JSON-RPC URL — this server appends /json_rpc.

Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "dero-daemon": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/dero-mcp-server/dist/index.js"]
    }
  }
}

Optional: add "env": { "DERO_DAEMON_URL": "http://127.0.0.1:10102" } if you use a local daemon instead of the default public RPC.

Restart Claude Desktop.

Cursor

In Cursor Settings → MCP, add a server that runs the same command / args / env as above.

Environment

Variable	Default	Description
`DERO_DAEMON_URL`	`http://82.65.143.182:10102`	Daemon base URL (no `/json_rpc` required). Set to `http://127.0.0.1:10102` for a local daemon.

Testing

# Check daemon connectivity
npm run doctor

# Run flow tests (10 RPC checks)
npm run test:flows

# Typecheck
npm run typecheck

Flow tests run against the default public RPC. Set DERO_DAEMON_URL to test against your own daemon.

CI runs on every push and PR — see .github/workflows/ci.yml.

Roadmap

Optional wallet-RPC tools behind DERO_ENABLE_WALLET_RPC=1 + separate URL.
Streamable HTTP transport for hosted MCP.
Stricter typing / OpenAPI-derived tool schemas.

License

MIT

dero-mcp-server