Read-only MCP server for the Symbol blockchain (XYM): node health, harvesting, voting keys.
Connect Runs on your machine
claude mcp add symbol -e SYMBOL_NODE_URL=<SYMBOL_NODE_URL> -e SYMBOL_NETWORK=<SYMBOL_NETWORK> -e SYMBOL_TIMEZONE=<SYMBOL_TIMEZONE> -e SYMBOL_REFERENCE_NODES=<SYMBOL_REFERENCE_NODES> -e SYMBOL_REQUEST_TIMEOUT_MS=<SYMBOL_REQUEST_TIMEOUT_MS> -e SYMBOL_STATE_DIR=<SYMBOL_STATE_DIR> -- npx -y [email protected]{
"mcpServers": {
"symbol": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SYMBOL_NODE_URL": "<SYMBOL_NODE_URL>",
"SYMBOL_NETWORK": "<SYMBOL_NETWORK>",
"SYMBOL_TIMEZONE": "<SYMBOL_TIMEZONE>",
"SYMBOL_REFERENCE_NODES": "<SYMBOL_REFERENCE_NODES>",
"SYMBOL_REQUEST_TIMEOUT_MS": "<SYMBOL_REQUEST_TIMEOUT_MS>",
"SYMBOL_STATE_DIR": "<SYMBOL_STATE_DIR>"
}
}
}
}{
"mcpServers": {
"symbol": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SYMBOL_NODE_URL": "<SYMBOL_NODE_URL>",
"SYMBOL_NETWORK": "<SYMBOL_NETWORK>",
"SYMBOL_TIMEZONE": "<SYMBOL_TIMEZONE>",
"SYMBOL_REFERENCE_NODES": "<SYMBOL_REFERENCE_NODES>",
"SYMBOL_REQUEST_TIMEOUT_MS": "<SYMBOL_REQUEST_TIMEOUT_MS>",
"SYMBOL_STATE_DIR": "<SYMBOL_STATE_DIR>"
}
}
}
}{
"servers": {
"symbol": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SYMBOL_NODE_URL": "<SYMBOL_NODE_URL>",
"SYMBOL_NETWORK": "<SYMBOL_NETWORK>",
"SYMBOL_TIMEZONE": "<SYMBOL_TIMEZONE>",
"SYMBOL_REFERENCE_NODES": "<SYMBOL_REFERENCE_NODES>",
"SYMBOL_REQUEST_TIMEOUT_MS": "<SYMBOL_REQUEST_TIMEOUT_MS>",
"SYMBOL_STATE_DIR": "<SYMBOL_STATE_DIR>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
SYMBOL_NODE_URLRequired | REST URL of the Symbol node to query, e.g. https://<node-host>:3001; https:// is required (http:// only for localhost / 127.0.0.1 / [::1]) and the port is used exactly as given. |
SYMBOL_NETWORKOptional | mainnet or testnet; when set, start-up fails if the node reports a different network. |
SYMBOL_TIMEZONEOptional | IANA zone such as Asia/Tokyo that adds a local time next to every UTC timestamp. |
SYMBOL_REFERENCE_NODESOptional | Comma-separated https:// node URLs that symbol_network_compare and symbol_version_drift check against; no other host is ever contacted. |
SYMBOL_REQUEST_TIMEOUT_MSOptional | Per-request timeout in milliseconds, 100 to 600000 (default 10000). |
SYMBOL_STATE_DIROptional | Absolute directory where symbol_harvesting_status keeps one snapshot file per node (unlocked harvester public keys, heights and times; no secrets) when it is asked to compare or save, created on first save with mode 0700; when unset, the tool reports the current list without a comparison. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 18 Oct 2026 |
| Last updated | 18 Oct 2026 |
| Registry name | io.github.inotakeh/symbol |
More finance and crypto servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.