# Symbol (XYM)

> Symbol (XYM) is an open-source MCP server for finance and payments. Read-only Symbol (XYM) blockchain tools for node health, harvesting and voting keys. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/inotakeh/symbol-mcp-server
- **MCP Registry name:** io.github.inotakeh/symbol
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-16

## About

Twenty task-level tools turn the Symbol node REST API into questions people actually ask, rather than mirroring each endpoint. Account holders can look up balances with aliases and decimals applied, transaction history with decoded messages, mosaics and namespaces, fee estimates and height-to-time conversions. Node operators get node status with a healthy-or-not verdict and sync check, delegated-harvesting status and income by month, comparison against reference nodes and, above all, voting-key expiry with a recommended renewal window.

Every answer carries structured content validated against a published schema plus a short summary whose first line answers the question. Amounts come both with divisibility applied and as raw integers, and timestamps are UTC with an optional local time. The model cannot point the server at another host, because everything is configured by environment variables.

It needs Node.js 22 or later and an https Symbol REST node. It supports Symbol only, not NEM NIS1 (XEM), and is an unofficial, independent project. A Claude Desktop bundle is available as well as npm.

## Features

- **Node health:** symbol_node_status folds seven checks into one verdict and reports sync state.
- **Voting-key expiry:** Reports remaining epochs, blocks and days and a recommended renewal window.
- **Harvesting income:** symbol_harvesting_income sums receipts by month and can output CSV.
- **Reference comparison:** symbol_network_compare and symbol_version_drift check against nodes you list.
- **Account lookups:** Balances, transactions, mosaics, namespaces, fees and address validation.
- **Structured answers:** Each tool returns schema-validated JSON with a short summary first.

## Good for

- Check whether a Symbol node is in sync
- Find out when a node's voting keys need renewing
- Work out harvesting earnings per month
- Compare a node's version with reference nodes

## Install

### Claude Code (Terminal)

```sh
claude mcp add symbol --env SYMBOL_NODE_URL='<SYMBOL_NODE_URL>' -- npx -y symbol-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "symbol": {
      "command": "npx",
      "args": [
        "-y",
        "symbol-mcp-server"
      ],
      "env": {
        "SYMBOL_NODE_URL": "<SYMBOL_NODE_URL>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "symbol": {
      "command": "npx",
      "args": [
        "-y",
        "symbol-mcp-server"
      ],
      "env": {
        "SYMBOL_NODE_URL": "<SYMBOL_NODE_URL>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "symbol": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "symbol-mcp-server"
      ],
      "env": {
        "SYMBOL_NODE_URL": "<SYMBOL_NODE_URL>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "symbol": {
      "command": "npx",
      "args": [
        "-y",
        "symbol-mcp-server"
      ],
      "env": {
        "SYMBOL_NODE_URL": "<SYMBOL_NODE_URL>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "symbol": {
      "command": "npx",
      "args": [
        "-y",
        "symbol-mcp-server"
      ],
      "env": {
        "SYMBOL_NODE_URL": "<SYMBOL_NODE_URL>"
      }
    }
  }
}
```

## Tools

- `symbol_node_status`: Node health verdict and sync state
- `symbol_harvesting_income`: Harvesting receipts by period, optionally CSV
- `symbol_harvesting_status`: Delegated harvesting status with optional snapshot comparison
- `symbol_network_compare`: Compare a node against reference nodes
- `symbol_version_drift`: Check node version against reference nodes

## FAQ

### Is it read-only?

Yes. The README describes it as a read-only server.

### Does it support NEM (XEM)?

No. It supports Symbol nodes only, not NEM NIS1.

### What do I need to run it?

Node.js 22 or newer and a Symbol REST node reachable over https, such as port 3001 on most public nodes.

### Is it official?

No. The README says it is independent and unaffiliated with the NEM or Symbol core teams.

### Is Symbol (XYM) free?

Yes. Symbol (XYM) is open source, so you can use and self-host it for free.

### How do I add Symbol (XYM) to Claude Code?

Run this command in your terminal: claude mcp add symbol --env SYMBOL_NODE_URL='<SYMBOL_NODE_URL>' -- npx -y symbol-mcp-server

### What are the best alternatives to Symbol (XYM)?

The closest alternatives to Symbol (XYM) are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/symbol-xym
