dero-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# DERO MCP server
+
+[Model Context Protocol](https://modelcontextprotocol.io) (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
+
+```bash
+cd dero-mcp-server
+npm install
+npm run build
+```
+
+Run (same default RPC as below if `DERO_DAEMON_URL` is unset):
+
+```bash
+node dist/index.js
+```
+
+Or set an explicit URL (e.g. your local daemon):
+
+```bash
+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`):
+
+```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. |
+
+## 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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createDeroMcpServer } from './server.js';
+/** Default public mainnet JSON-RPC (override with DERO_DAEMON_URL). */
+const DEFAULT_DAEMON_BASE = 'http://82.65.143.182:10102';
+function daemonUrlFromEnv() {
+    const fromEnv = process.env.DERO_DAEMON_URL?.trim();
+    if (fromEnv)
+        return fromEnv.replace(/\/json_rpc\/?$/, '');
+    return DEFAULT_DAEMON_BASE;
+}
+async function main() {
+    const base = daemonUrlFromEnv();
+    const server = createDeroMcpServer(base);
+    const transport = new StdioServerTransport();
+    process.stderr.write(`[dero-mcp-server] DERO_DAEMON_URL base: ${base} (JSON-RPC at ${base.replace(/\/$/, '')}/json_rpc)\n`);
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`[dero-mcp-server] fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,uEAAuE;AACvE,MAAM,mBAAmB,GAAG,4BAA4B,CAAA;AAExD,SAAS,gBAAgB;IACvB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAA;IACnD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;IACzD,OAAO,mBAAmB,CAAA;AAC5B,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;IAExC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAE5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2CAA2C,IAAI,iBAAiB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CACtG,CAAA;IAED,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACtG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/rpc.d.ts

@@ -0,0 +1,18 @@
+export type JsonRpcResponse<T = unknown> = {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: T;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+};
+/**
+ * POST JSON-RPC 2.0 to a DERO daemon or wallet endpoint (…/json_rpc).
+ */
+export declare function deroJsonRpc<T = unknown>(jsonRpcUrl: string, method: string, params?: unknown, options?: {
+    timeoutMs?: number;
+}): Promise<T>;
+export declare function jsonRpcEndpoint(baseUrl: string): string;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI;IACzC,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,CAAC,CAAA;IACV,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAC1D,CAAA;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,CAAC,CAAC,CAqCZ;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/rpc.js

@@ -0,0 +1,47 @@
+const DEFAULT_TIMEOUT_MS = 45_000;
+/**
+ * POST JSON-RPC 2.0 to a DERO daemon or wallet endpoint (…/json_rpc).
+ */
+export async function deroJsonRpc(jsonRpcUrl, method, params, options) {
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const body = {
+        jsonrpc: '2.0',
+        id: 'dero-mcp',
+        method,
+    };
+    if (params !== undefined)
+        body.params = params;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(jsonRpcUrl, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            throw new Error(`HTTP ${res.status}: ${text.slice(0, 500)}`);
+        }
+        let json;
+        try {
+            json = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`Invalid JSON from node: ${text.slice(0, 200)}`);
+        }
+        if (json.error) {
+            throw new Error(`RPC error ${json.error.code}: ${json.error.message}${json.error.data != null ? ` ${JSON.stringify(json.error.data)}` : ''}`);
+        }
+        return json.result;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export function jsonRpcEndpoint(baseUrl) {
+    const trimmed = baseUrl.replace(/\/$/, '');
+    return trimmed.endsWith('/json_rpc') ? trimmed : `${trimmed}/json_rpc`;
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,MAAM,CAAA;AASjC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAkB,EAClB,MAAc,EACd,MAAgB,EAChB,OAAgC;IAEhC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,kBAAkB,CAAA;IAC1D,MAAM,IAAI,GAA4B;QACpC,OAAO,EAAE,KAAK;QACd,EAAE,EAAE,UAAU;QACd,MAAM;KACP,CAAA;IACD,IAAI,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IAE9C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAA;IAC7D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QAC9D,CAAC;QACD,IAAI,IAAwB,CAAA;QAC5B,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAA;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QAClE,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7H,CAAA;QACH,CAAC;QACD,OAAO,IAAI,CAAC,MAAW,CAAA;IACzB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC1C,OAAO,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,WAAW,CAAA;AACxE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createDeroMcpServer(daemonBaseUrl: string): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAqBnE,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAuSpE"}

package/dist/server.js

@@ -0,0 +1,222 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { deroJsonRpc, jsonRpcEndpoint } from './rpc.js';
+const scRpcArgSchema = z.object({
+    name: z.string(),
+    datatype: z.enum(['S', 'U', 'H']),
+    value: z.union([z.string(), z.number()]),
+});
+function toolText(data) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: typeof data === 'string' ? data : JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+export function createDeroMcpServer(daemonBaseUrl) {
+    const endpoint = jsonRpcEndpoint(daemonBaseUrl);
+    const rpc = async (method, params) => deroJsonRpc(endpoint, method, params);
+    const server = new McpServer({
+        name: 'dero-daemon-mcp',
+        version: '0.1.0',
+    });
+    server.registerTool('dero_daemon_ping', {
+        description: 'DERO daemon connectivity check. Calls DERO.Ping. No parameters.',
+    }, async () => toolText(await rpc('DERO.Ping')));
+    server.registerTool('dero_daemon_echo', {
+        description: 'Echo strings through the daemon (DERO.Echo).',
+        inputSchema: {
+            words: z.array(z.string()).describe('Strings to echo back'),
+        },
+    }, async ({ words }) => toolText(await rpc('DERO.Echo', words)));
+    server.registerTool('dero_get_info', {
+        description: 'Get daemon / chain info: height, difficulty, version, mempool size, etc. (DERO.GetInfo).',
+    }, async () => toolText(await rpc('DERO.GetInfo')));
+    server.registerTool('dero_get_height', {
+        description: 'Get top block height and stable/topo heights (DERO.GetHeight).',
+    }, async () => toolText(await rpc('DERO.GetHeight')));
+    server.registerTool('dero_get_block_count', {
+        description: 'Total block count (DERO.GetBlockCount).',
+    }, async () => toolText(await rpc('DERO.GetBlockCount')));
+    server.registerTool('dero_get_last_block_header', {
+        description: 'Header of the tip block (DERO.GetLastBlockHeader).',
+    }, async () => toolText(await rpc('DERO.GetLastBlockHeader')));
+    server.registerTool('dero_get_block', {
+        description: 'Fetch a full block by height or hash (DERO.GetBlock). Provide one of hash or height.',
+        inputSchema: {
+            hash: z
+                .string()
+                .optional()
+                .describe('64-char hex block hash'),
+            height: z
+                .number()
+                .int()
+                .nonnegative()
+                .optional()
+                .describe('Block height'),
+        },
+    }, async (args) => {
+        if (!args.hash && args.height === undefined) {
+            throw new Error('Provide either hash or height');
+        }
+        const params = {};
+        if (args.hash)
+            params.hash = args.hash;
+        if (args.height !== undefined)
+            params.height = args.height;
+        return toolText(await rpc('DERO.GetBlock', params));
+    });
+    server.registerTool('dero_get_block_header_by_topo_height', {
+        description: 'Block header by topological height (DERO.GetBlockHeaderByTopoHeight).',
+        inputSchema: {
+            topoheight: z
+                .number()
+                .int()
+                .nonnegative()
+                .describe('Topological height'),
+        },
+    }, async ({ topoheight }) => toolText(await rpc('DERO.GetBlockHeaderByTopoHeight', { topoheight })));
+    server.registerTool('dero_get_block_header_by_hash', {
+        description: 'Block header by hash (DERO.GetBlockHeaderByHash).',
+        inputSchema: {
+            hash: z.string().describe('Block top hash (hex)'),
+        },
+    }, async ({ hash }) => toolText(await rpc('DERO.GetBlockHeaderByHash', { hash })));
+    server.registerTool('dero_get_tx_pool', {
+        description: 'Pending mempool transaction hashes (DERO.GetTxPool).',
+    }, async () => toolText(await rpc('DERO.GetTxPool')));
+    server.registerTool('dero_get_random_address', {
+        description: 'Random registered addresses from chain (for ring construction); optional asset scid (DERO.GetRandomAddress).',
+        inputSchema: {
+            scid: z
+                .string()
+                .optional()
+                .describe('Optional asset smart-contract id (hex)'),
+        },
+    }, async (args) => toolText(await rpc('DERO.GetRandomAddress', args.scid != null ? { scid: args.scid } : undefined)));
+    server.registerTool('dero_get_transaction', {
+        description: 'Fetch transactions by tx hashes (DERO.GetTransaction).',
+        inputSchema: {
+            txs_hashes: z
+                .array(z.string())
+                .min(1)
+                .describe('List of transaction hashes (hex)'),
+            decode_as_json: z
+                .number()
+                .int()
+                .optional()
+                .describe('Optional: decode each tx as JSON when non-zero'),
+        },
+    }, async ({ txs_hashes, decode_as_json }) => {
+        const params = { txs_hashes };
+        if (decode_as_json !== undefined)
+            params.decode_as_json = decode_as_json;
+        return toolText(await rpc('DERO.GetTransaction', params));
+    });
+    server.registerTool('dero_get_encrypted_balance', {
+        description: 'Encrypted balance blob for an address at a topo height (DERO.GetEncryptedBalance). Not cleartext balance.',
+        inputSchema: {
+            address: z.string().describe('DERO address (deto1…)'),
+            topoheight: z
+                .number()
+                .int()
+                .describe('Use -1 for latest chain tip'),
+            scid: z.string().optional().describe('Asset SCID hex; omit for native DERO'),
+        },
+    }, async ({ address, topoheight, scid }) => {
+        const params = { address, topoheight };
+        if (scid)
+            params.scid = scid;
+        return toolText(await rpc('DERO.GetEncryptedBalance', params));
+    });
+    server.registerTool('dero_get_sc', {
+        description: 'Read smart contract code and/or variables by SCID (DERO.GetSC).',
+        inputSchema: {
+            scid: z.string().describe('64-char hex Smart Contract ID'),
+            code: z
+                .boolean()
+                .optional()
+                .describe('Include contract source (default true)'),
+            variables: z
+                .boolean()
+                .optional()
+                .describe('Include stored variables (default true)'),
+            topoheight: z
+                .number()
+                .int()
+                .optional()
+                .describe('Topo height; omit or use -1 for latest'),
+        },
+    }, async ({ scid, code, variables, topoheight }) => {
+        const params = {
+            scid,
+            code: code ?? true,
+            variables: variables ?? true,
+        };
+        if (topoheight !== undefined)
+            params.topoheight = topoheight;
+        return toolText(await rpc('DERO.GetSC', params));
+    });
+    server.registerTool('dero_get_gas_estimate', {
+        description: 'Estimate gas (compute + storage) for transfers, deploy, or SC call (DERO.GetGasEstimate).',
+        inputSchema: {
+            transfers: z
+                .array(z.record(z.unknown()))
+                .optional()
+                .describe('Optional transfer list'),
+            sc: z.string().optional().describe('SC source to deploy'),
+            sc_rpc: z
+                .array(scRpcArgSchema)
+                .optional()
+                .describe('SC invocation arguments (entrypoint, SC_ID, etc.)'),
+            signer: z
+                .string()
+                .optional()
+                .describe('Signer address used for estimation'),
+        },
+    }, async (args) => {
+        const params = {};
+        if (args.transfers)
+            params.transfers = args.transfers;
+        if (args.sc)
+            params.sc = args.sc;
+        if (args.sc_rpc)
+            params.sc_rpc = args.sc_rpc;
+        if (args.signer)
+            params.signer = args.signer;
+        return toolText(await rpc('DERO.GetGasEstimate', params));
+    });
+    server.registerTool('dero_name_to_address', {
+        description: 'Resolve a DERO on-chain name to address (DERO.NameToAddress).',
+        inputSchema: {
+            name: z.string().describe('Registered name'),
+            topoheight: z
+                .number()
+                .int()
+                .describe('Use -1 for latest'),
+        },
+    }, async ({ name, topoheight }) => toolText(await rpc('DERO.NameToAddress', { name, topoheight })));
+    server.registerTool('dero_get_block_template', {
+        description: 'Mining: get block template for a miner address (DERO.GetBlockTemplate).',
+        inputSchema: {
+            wallet_address: z.string().describe('Miner payout DERO address'),
+            block: z
+                .boolean()
+                .optional()
+                .describe('Include block blob'),
+            miner: z.string().optional().describe('Optional miner id / label'),
+        },
+    }, async ({ wallet_address, block, miner }) => {
+        const params = { wallet_address };
+        if (block !== undefined)
+            params.block = block;
+        if (miner)
+            params.miner = miner;
+        return toolText(await rpc('DERO.GetBlockTemplate', params));
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "dero-mcp-server",
+  "version": "0.1.0",
+  "description": "Model Context Protocol (MCP) server exposing DERO Stargate daemon JSON-RPC to Claude and other MCP clients",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.js",
+  "bin": {
+    "dero-mcp-server": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "node --import tsx src/index.ts",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.8.0"
+  },
+  "keywords": [
+    "dero",
+    "mcp",
+    "model-context-protocol",
+    "blockchain",
+    "json-rpc"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DHEBP/dero-mcp-server.git"
+  },
+  "homepage": "https://derod.org",
+  "bugs": {
+    "url": "https://github.com/DHEBP/dero-mcp-server/issues"
+  }
+}

package/src/index.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { createDeroMcpServer } from './server.js'
+
+/** Default public mainnet JSON-RPC (override with DERO_DAEMON_URL). */
+const DEFAULT_DAEMON_BASE = 'http://82.65.143.182:10102'
+
+function daemonUrlFromEnv(): string {
+  const fromEnv = process.env.DERO_DAEMON_URL?.trim()
+  if (fromEnv) return fromEnv.replace(/\/json_rpc\/?$/, '')
+  return DEFAULT_DAEMON_BASE
+}
+
+async function main() {
+  const base = daemonUrlFromEnv()
+  const server = createDeroMcpServer(base)
+
+  const transport = new StdioServerTransport()
+
+  process.stderr.write(
+    `[dero-mcp-server] DERO_DAEMON_URL base: ${base} (JSON-RPC at ${base.replace(/\/$/, '')}/json_rpc)\n`,
+  )
+
+  await server.connect(transport)
+}
+
+main().catch((err) => {
+  process.stderr.write(`[dero-mcp-server] fatal: ${err instanceof Error ? err.message : String(err)}\n`)
+  process.exit(1)
+})

package/src/rpc.ts

@@ -0,0 +1,60 @@
+const DEFAULT_TIMEOUT_MS = 45_000
+
+export type JsonRpcResponse<T = unknown> = {
+  jsonrpc: '2.0'
+  id: string | number
+  result?: T
+  error?: { code: number; message: string; data?: unknown }
+}
+
+/**
+ * POST JSON-RPC 2.0 to a DERO daemon or wallet endpoint (…/json_rpc).
+ */
+export async function deroJsonRpc<T = unknown>(
+  jsonRpcUrl: string,
+  method: string,
+  params?: unknown,
+  options?: { timeoutMs?: number },
+): Promise<T> {
+  const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS
+  const body: Record<string, unknown> = {
+    jsonrpc: '2.0',
+    id: 'dero-mcp',
+    method,
+  }
+  if (params !== undefined) body.params = params
+
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), timeoutMs)
+  try {
+    const res = await fetch(jsonRpcUrl, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify(body),
+      signal: controller.signal,
+    })
+    const text = await res.text()
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status}: ${text.slice(0, 500)}`)
+    }
+    let json: JsonRpcResponse<T>
+    try {
+      json = JSON.parse(text) as JsonRpcResponse<T>
+    } catch {
+      throw new Error(`Invalid JSON from node: ${text.slice(0, 200)}`)
+    }
+    if (json.error) {
+      throw new Error(
+        `RPC error ${json.error.code}: ${json.error.message}${json.error.data != null ? ` ${JSON.stringify(json.error.data)}` : ''}`,
+      )
+    }
+    return json.result as T
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+export function jsonRpcEndpoint(baseUrl: string): string {
+  const trimmed = baseUrl.replace(/\/$/, '')
+  return trimmed.endsWith('/json_rpc') ? trimmed : `${trimmed}/json_rpc`
+}

package/src/server.ts

@@ -0,0 +1,317 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { z } from 'zod'
+import { deroJsonRpc, jsonRpcEndpoint } from './rpc.js'
+
+const scRpcArgSchema = z.object({
+  name: z.string(),
+  datatype: z.enum(['S', 'U', 'H']),
+  value: z.union([z.string(), z.number()]),
+})
+
+function toolText(data: unknown) {
+  return {
+    content: [
+      {
+        type: 'text' as const,
+        text: typeof data === 'string' ? data : JSON.stringify(data, null, 2),
+      },
+    ],
+  }
+}
+
+export function createDeroMcpServer(daemonBaseUrl: string): McpServer {
+  const endpoint = jsonRpcEndpoint(daemonBaseUrl)
+  const rpc = async <T>(method: string, params?: unknown) =>
+    deroJsonRpc<T>(endpoint, method, params)
+
+  const server = new McpServer({
+    name: 'dero-daemon-mcp',
+    version: '0.1.0',
+  })
+
+  server.registerTool(
+    'dero_daemon_ping',
+    {
+      description:
+        'DERO daemon connectivity check. Calls DERO.Ping. No parameters.',
+    },
+    async () => toolText(await rpc<string>('DERO.Ping')),
+  )
+
+  server.registerTool(
+    'dero_daemon_echo',
+    {
+      description: 'Echo strings through the daemon (DERO.Echo).',
+      inputSchema: {
+        words: z.array(z.string()).describe('Strings to echo back'),
+      },
+    },
+    async ({ words }) => toolText(await rpc<string>('DERO.Echo', words)),
+  )
+
+  server.registerTool(
+    'dero_get_info',
+    {
+      description:
+        'Get daemon / chain info: height, difficulty, version, mempool size, etc. (DERO.GetInfo).',
+    },
+    async () => toolText(await rpc('DERO.GetInfo')),
+  )
+
+  server.registerTool(
+    'dero_get_height',
+    {
+      description: 'Get top block height and stable/topo heights (DERO.GetHeight).',
+    },
+    async () => toolText(await rpc('DERO.GetHeight')),
+  )
+
+  server.registerTool(
+    'dero_get_block_count',
+    {
+      description: 'Total block count (DERO.GetBlockCount).',
+    },
+    async () => toolText(await rpc('DERO.GetBlockCount')),
+  )
+
+  server.registerTool(
+    'dero_get_last_block_header',
+    {
+      description: 'Header of the tip block (DERO.GetLastBlockHeader).',
+    },
+    async () => toolText(await rpc('DERO.GetLastBlockHeader')),
+  )
+
+  server.registerTool(
+    'dero_get_block',
+    {
+      description: 'Fetch a full block by height or hash (DERO.GetBlock). Provide one of hash or height.',
+      inputSchema: {
+        hash: z
+          .string()
+          .optional()
+          .describe('64-char hex block hash'),
+        height: z
+          .number()
+          .int()
+          .nonnegative()
+          .optional()
+          .describe('Block height'),
+      },
+    },
+    async (args) => {
+      if (!args.hash && args.height === undefined) {
+        throw new Error('Provide either hash or height')
+      }
+      const params: Record<string, unknown> = {}
+      if (args.hash) params.hash = args.hash
+      if (args.height !== undefined) params.height = args.height
+      return toolText(await rpc('DERO.GetBlock', params))
+    },
+  )
+
+  server.registerTool(
+    'dero_get_block_header_by_topo_height',
+    {
+      description: 'Block header by topological height (DERO.GetBlockHeaderByTopoHeight).',
+      inputSchema: {
+        topoheight: z
+          .number()
+          .int()
+          .nonnegative()
+          .describe('Topological height'),
+      },
+    },
+    async ({ topoheight }) =>
+      toolText(await rpc('DERO.GetBlockHeaderByTopoHeight', { topoheight })),
+  )
+
+  server.registerTool(
+    'dero_get_block_header_by_hash',
+    {
+      description: 'Block header by hash (DERO.GetBlockHeaderByHash).',
+      inputSchema: {
+        hash: z.string().describe('Block top hash (hex)'),
+      },
+    },
+    async ({ hash }) =>
+      toolText(await rpc('DERO.GetBlockHeaderByHash', { hash })),
+  )
+
+  server.registerTool(
+    'dero_get_tx_pool',
+    {
+      description: 'Pending mempool transaction hashes (DERO.GetTxPool).',
+    },
+    async () => toolText(await rpc('DERO.GetTxPool')),
+  )
+
+  server.registerTool(
+    'dero_get_random_address',
+    {
+      description:
+        'Random registered addresses from chain (for ring construction); optional asset scid (DERO.GetRandomAddress).',
+      inputSchema: {
+        scid: z
+          .string()
+          .optional()
+          .describe('Optional asset smart-contract id (hex)'),
+      },
+    },
+    async (args) =>
+      toolText(
+        await rpc(
+          'DERO.GetRandomAddress',
+          args.scid != null ? { scid: args.scid } : undefined,
+        ),
+      ),
+  )
+
+  server.registerTool(
+    'dero_get_transaction',
+    {
+      description: 'Fetch transactions by tx hashes (DERO.GetTransaction).',
+      inputSchema: {
+        txs_hashes: z
+          .array(z.string())
+          .min(1)
+          .describe('List of transaction hashes (hex)'),
+        decode_as_json: z
+          .number()
+          .int()
+          .optional()
+          .describe('Optional: decode each tx as JSON when non-zero'),
+      },
+    },
+    async ({ txs_hashes, decode_as_json }) => {
+      const params: Record<string, unknown> = { txs_hashes }
+      if (decode_as_json !== undefined) params.decode_as_json = decode_as_json
+      return toolText(await rpc('DERO.GetTransaction', params))
+    },
+  )
+
+  server.registerTool(
+    'dero_get_encrypted_balance',
+    {
+      description:
+        'Encrypted balance blob for an address at a topo height (DERO.GetEncryptedBalance). Not cleartext balance.',
+      inputSchema: {
+        address: z.string().describe('DERO address (deto1…)'),
+        topoheight: z
+          .number()
+          .int()
+          .describe('Use -1 for latest chain tip'),
+        scid: z.string().optional().describe('Asset SCID hex; omit for native DERO'),
+      },
+    },
+    async ({ address, topoheight, scid }) => {
+      const params: Record<string, unknown> = { address, topoheight }
+      if (scid) params.scid = scid
+      return toolText(await rpc('DERO.GetEncryptedBalance', params))
+    },
+  )
+
+  server.registerTool(
+    'dero_get_sc',
+    {
+      description:
+        'Read smart contract code and/or variables by SCID (DERO.GetSC).',
+      inputSchema: {
+        scid: z.string().describe('64-char hex Smart Contract ID'),
+        code: z
+          .boolean()
+          .optional()
+          .describe('Include contract source (default true)'),
+        variables: z
+          .boolean()
+          .optional()
+          .describe('Include stored variables (default true)'),
+        topoheight: z
+          .number()
+          .int()
+          .optional()
+          .describe('Topo height; omit or use -1 for latest'),
+      },
+    },
+    async ({ scid, code, variables, topoheight }) => {
+      const params: Record<string, unknown> = {
+        scid,
+        code: code ?? true,
+        variables: variables ?? true,
+      }
+      if (topoheight !== undefined) params.topoheight = topoheight
+      return toolText(await rpc('DERO.GetSC', params))
+    },
+  )
+
+  server.registerTool(
+    'dero_get_gas_estimate',
+    {
+      description:
+        'Estimate gas (compute + storage) for transfers, deploy, or SC call (DERO.GetGasEstimate).',
+      inputSchema: {
+        transfers: z
+          .array(z.record(z.unknown()))
+          .optional()
+          .describe('Optional transfer list'),
+        sc: z.string().optional().describe('SC source to deploy'),
+        sc_rpc: z
+          .array(scRpcArgSchema)
+          .optional()
+          .describe('SC invocation arguments (entrypoint, SC_ID, etc.)'),
+        signer: z
+          .string()
+          .optional()
+          .describe('Signer address used for estimation'),
+      },
+    },
+    async (args) => {
+      const params: Record<string, unknown> = {}
+      if (args.transfers) params.transfers = args.transfers
+      if (args.sc) params.sc = args.sc
+      if (args.sc_rpc) params.sc_rpc = args.sc_rpc
+      if (args.signer) params.signer = args.signer
+      return toolText(await rpc('DERO.GetGasEstimate', params))
+    },
+  )
+
+  server.registerTool(
+    'dero_name_to_address',
+    {
+      description: 'Resolve a DERO on-chain name to address (DERO.NameToAddress).',
+      inputSchema: {
+        name: z.string().describe('Registered name'),
+        topoheight: z
+          .number()
+          .int()
+          .describe('Use -1 for latest'),
+      },
+    },
+    async ({ name, topoheight }) =>
+      toolText(await rpc('DERO.NameToAddress', { name, topoheight })),
+  )
+
+  server.registerTool(
+    'dero_get_block_template',
+    {
+      description:
+        'Mining: get block template for a miner address (DERO.GetBlockTemplate).',
+      inputSchema: {
+        wallet_address: z.string().describe('Miner payout DERO address'),
+        block: z
+          .boolean()
+          .optional()
+          .describe('Include block blob'),
+        miner: z.string().optional().describe('Optional miner id / label'),
+      },
+    },
+    async ({ wallet_address, block, miner }) => {
+      const params: Record<string, unknown> = { wallet_address }
+      if (block !== undefined) params.block = block
+      if (miner) params.miner = miner
+      return toolText(await rpc('DERO.GetBlockTemplate', params))
+    },
+  )
+
+  return server
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "esModuleInterop": true
+  },
+  "include": ["src/**/*.ts"]
+}