voyager-mcp

voyager-mcp

MCP server that gives AI coding agents live Voyager Starknet data — transactions, contracts, classes, tokens, NFTs, staking, events, blocks, messages and network stats.

• Thin client over the Voyager API — the same data the explorer uses.
• No API key. Runs locally over stdio via npx — nothing to host.
• Mainnet & Sepolia.

📖 Full docs, setup & agent recipes: https://docs.voyager.online/ai/mcp-quickstart

Requirements

• Node.js 20.3+ (npx ships with it)
• An MCP client: Claude Code, Claude Desktop, Cursor, or Codex

There is nothing to install or build — npx -y voyager-mcp downloads and runs the server.

Setup

Claude Code

claude mcp add voyager -- npx -y voyager-mcp

Or commit it to your project by adding .mcp.json:

{
  "mcpServers": {
    "voyager": { "command": "npx", "args": ["-y", "voyager-mcp"] }
  }
}

Claude Desktop

Open Settings → Developer → Edit Config and add the voyager server, then fully quit (⌘Q) and reopen Claude Desktop:

{
  "mcpServers": {
    "voyager": { "command": "npx", "args": ["-y", "voyager-mcp"] }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project), then enable it under Cursor Settings → MCP:

{
  "mcpServers": {
    "voyager": { "command": "npx", "args": ["-y", "voyager-mcp"] }
  }
}

Codex

codex mcp add voyager -- npx -y voyager-mcp

Or add it manually to ~/.codex/config.toml:

[mcp_servers.voyager]
command = "npx"
args = ["-y", "voyager-mcp"]

Sepolia testnet: add "env": { "VOYAGER_NETWORK": "sepolia" } to the server entry (Codex/TOML: env = { "VOYAGER_NETWORK" = "sepolia" }). Windows: if npx isn't found, use "command": "npx.cmd".

Example prompts

Once it's connected, ask your agent things like:

• "Use voyager to get the current Starknet network stats"
• "Look up Starknet transaction 0x… and the events it emitted"
• "Show me the verified Cairo code for class 0x…"
• "What's the class hash and type of contract 0x…?"
• "List the latest 10 Starknet blocks"
• "Who are the top holders of token 0x…?"

Tools

~83 tools. Core (transactions, blocks, contracts, classes & Cairo code, tokens, events, messages, stats, L1) is always on; the NFT, Staking and Search groups are on by default.

Full catalog + the recipes an agent uses to chain calls: https://docs.voyager.online/ai/mcp-tools

Configuration

Env var	Values	Default
VOYAGER_NETWORK	mainnet · sepolia	mainnet
VOYAGER_TOOLS	none (core only) · a comma list like nft,search	all groups on

Verify

npx -y voyager-mcp     # starts the server on stdio (Ctrl+C to exit)

No API key required. Data comes from the Voyager API over HTTPS.