Symbol MCP

A read-only Model Context Protocol server for the Symbol blockchain (XYM) that exposes 20 task-level tools. It allows agents to query account balances, transaction history, mosaic and namespace details, node health, sync status, harvesting information, and voting key expiry data by interacting with Symbol catapult nodes.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Community listingLocal stdioSource reviewed; not executedPublished by inotakeh

Vendor documentation

What you can do with it

Check node health and synchronization status
Retrieve account balances and transaction history
Monitor delegated-harvesting status
Check voting key expiry and renewal windows

Source and maintenance

Community listingRegistry 0.10.2

mcp-registry: io.github.inotakeh/symbol@0.10.2 Source repository Project website

Maintenance checked: Oct 31, 2026, 10:59 PM UTC

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

symbol-mcp-server 0.10.2

npm

symbol-mcp-server package definition

{
  "version": "0.10.2",
  "transport": "stdio",
  "identifier": "symbol-mcp-server",
  "registryType": "npm",
  "environmentVariables": [
    {
      "name": "SYMBOL_NODE_URL",
      "format": "string",
      "isRequired": true,
      "description": "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."
    },
    {
      "name": "SYMBOL_NETWORK",
      "format": "string",
      "description": "mainnet or testnet; when set, start-up fails if the node reports a different network."
    },
    {
      "name": "SYMBOL_TIMEZONE",
      "format": "string",
      "description": "IANA zone such as Asia/Tokyo that adds a local time next to every UTC timestamp."
    },
    {
      "name": "SYMBOL_REFERENCE_NODES",
      "format": "string",
      "description": "Comma-separated https:// node URLs that symbol_network_compare and symbol_version_drift check against; no other host is ever contacted."
    },
    {
      "name": "SYMBOL_REQUEST_TIMEOUT_MS",
      "format": "string",
      "description": "Per-request timeout in milliseconds, 100 to 600000 (default 10000)."
    },
    {
      "name": "SYMBOL_STATE_DIR",
      "format": "string",
      "description": "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."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "symbol-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "symbol-mcp-server@0.10.2"
      ],
      "env": {
        "SYMBOL_NODE_URL": "<YOUR_SYMBOL_NODE_URL>",
        "SYMBOL_NETWORK": "<YOUR_SYMBOL_NETWORK>",
        "SYMBOL_TIMEZONE": "<YOUR_SYMBOL_TIMEZONE>",
        "SYMBOL_REFERENCE_NODES": "<YOUR_SYMBOL_REFERENCE_NODES>",
        "SYMBOL_REQUEST_TIMEOUT_MS": "<YOUR_SYMBOL_REQUEST_TIMEOUT_MS>",
        "SYMBOL_STATE_DIR": "<YOUR_SYMBOL_STATE_DIR>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "symbol-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "symbol-mcp-server@0.10.2"
      ],
      "env": {
        "SYMBOL_NODE_URL": "<YOUR_SYMBOL_NODE_URL>",
        "SYMBOL_NETWORK": "<YOUR_SYMBOL_NETWORK>",
        "SYMBOL_TIMEZONE": "<YOUR_SYMBOL_TIMEZONE>",
        "SYMBOL_REFERENCE_NODES": "<YOUR_SYMBOL_REFERENCE_NODES>",
        "SYMBOL_REQUEST_TIMEOUT_MS": "<YOUR_SYMBOL_REQUEST_TIMEOUT_MS>",
        "SYMBOL_STATE_DIR": "<YOUR_SYMBOL_STATE_DIR>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "symbol-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "symbol-mcp-server@0.10.2"
      ],
      "env": {
        "SYMBOL_NODE_URL": "<YOUR_SYMBOL_NODE_URL>",
        "SYMBOL_NETWORK": "<YOUR_SYMBOL_NETWORK>",
        "SYMBOL_TIMEZONE": "<YOUR_SYMBOL_TIMEZONE>",
        "SYMBOL_REFERENCE_NODES": "<YOUR_SYMBOL_REFERENCE_NODES>",
        "SYMBOL_REQUEST_TIMEOUT_MS": "<YOUR_SYMBOL_REQUEST_TIMEOUT_MS>",
        "SYMBOL_STATE_DIR": "<YOUR_SYMBOL_STATE_DIR>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "symbol-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "symbol-mcp-server@0.10.2"
      ],
      "env": {
        "SYMBOL_NODE_URL": "<YOUR_SYMBOL_NODE_URL>",
        "SYMBOL_NETWORK": "<YOUR_SYMBOL_NETWORK>",
        "SYMBOL_TIMEZONE": "<YOUR_SYMBOL_TIMEZONE>",
        "SYMBOL_REFERENCE_NODES": "<YOUR_SYMBOL_REFERENCE_NODES>",
        "SYMBOL_REQUEST_TIMEOUT_MS": "<YOUR_SYMBOL_REQUEST_TIMEOUT_MS>",
        "SYMBOL_STATE_DIR": "<YOUR_SYMBOL_STATE_DIR>"
      }
    }
  }
}

Let your agent find its tools

Find servers like Symbol MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 4,318