Build and configure the Stealth MCP server for JSON-RPC-based read-only access to a StealthCoind node. Exposes 20+ tools for querying node state, blockchain data, staker information, and address balances. Works with any MCP-compatible AI assistant. Use when setting up MCP access to a Stealth node.
Build and configure an MCP (Model Context Protocol) server that connects AI assistants to a StealthCoind node via JSON-RPC. The server exposes 20+ read-only tools for querying blockchain state.
# Build from source
skills/stealth-mcp-server/scripts/install.sh
# Configure connection to StealthCoind
skills/stealth-mcp-server/scripts/configure.sh
# Register with Claude Code
skills/stealth-mcp-server/scripts/setup-claude-config.sh --scope project
Restart Claude Code, then:
Show me my Stealth node info and current balance
claude mcp add --transport stdio stealth -- npx -y @stealthsend/stealth-mcp-server
The MCP server reads connection settings from environment variables or
a .env file in the stealth-mcp-server/ directory.
| Variable | Default | Description |
|---|---|---|
STEALTH_RPC_HOST | 127.0.0.1 | StealthCoind RPC host |
STEALTH_RPC_PORT | 46502 | StealthCoind RPC port |
STEALTH_RPC_USER | rpc | RPC username |
STEALTH_RPC_PASSWORD | (required) | RPC password |
STEALTH_TESTNET | false | Use testnet port (46503) |
| Tool | Description |
|---|---|
stealth_connect | Connect to StealthCoind with RPC credentials |
stealth_disconnect | Disconnect from StealthCoind |
stealth_connection_status | Check connection status |
| Tool | Description |
|---|---|
stealth_get_info | Node version, protocol, blocks, connections, balance |
stealth_get_difficulty | Current network difficulty |
stealth_get_peer_info | Connected peers |
stealth_get_connection_count | Number of peers |
| Tool | Description |
|---|---|
stealth_get_block_count | Current block height |
stealth_get_best_block_hash | Hash of the latest block |
stealth_get_block | Block details by hash |
stealth_get_block_by_number | Block details by height |
stealth_get_block_hash | Block hash by height |
| Tool | Description |
|---|---|
stealth_get_balance | Wallet balance |
stealth_list_transactions | Recent transactions |
stealth_get_transaction | Transaction details by txid |
stealth_list_unspent | Unspent transaction outputs |
stealth_validate_address | Validate an address |
| Tool | Description |
|---|---|
stealth_get_qpos_info | QPoS consensus state |
stealth_get_staker_info | Staker details by ID |
stealth_get_staker_price | Current staker purchase price |
stealth_get_stakers_by_id | All stakers sorted by ID |
stealth_get_stakers_by_weight | All stakers sorted by weight |
stealth_get_block_schedule | Upcoming block production schedule |
stealth_get_queue_summary | Current staker queue |
| Tool | Description |
|---|---|
stealth_get_address_balance | Balance for any address |
stealth_get_address_info | Address details |
stealth_get_rich_list | Top addresses by balance |
stealth_get_tx_volume | Transaction volume statistics |
The server runs on stdio transport. The MCP client launches it as a subprocess and communicates over stdin/stdout. No HTTP server, no port binding.
sequenceDiagram
participant AI as AI Assistant
participant MCP as stealth-mcp-server
participant XST as StealthCoind
AI->>MCP: stealth_connect(host, port, user, password)
MCP->>XST: JSON-RPC getinfo
XST-->>MCP: Node info
MCP-->>AI: Connected successfully
AI->>MCP: stealth_get_balance()
MCP->>XST: JSON-RPC getbalance
XST-->>MCP: Balance
MCP-->>AI: Formatted balance
| Path | Purpose |
|---|---|
stealth-mcp-server/.env | Connection config (not committed) |
stealth-mcp-server/ | Go source code |
.mcp.json | Claude Code MCP registration (not committed) |