million-mcp

MCP server for million, the open-source, self-hosted Solana whale tracker and copy-trading deck. It lets Claude Desktop, Cursor, Claude Code, VS Code or any MCP client read and operate your deck: status, positions, why a token was or wasn't bought, trading rules, roster order flow, token safety checks and finding wallets worth following.

It's a thin layer over the deck's local API, so the deck has to be running on your machine. No keys pass through it, and no tool can switch paper trading to live.

1. Run the deck

npx create-million

That clones, installs and starts million at http://localhost:5173 (you need Node 24 or nvm, and a free Helius API key).

2. Add the server to your client

Claude Code

claude mcp add million -- npx -y million-mcp

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and most other clients:

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

VS Code (.vscode/mcp.json):

{
  "servers": {
    "million": { "type": "stdio", "command": "npx", "args": ["-y", "million-mcp"] }
  }
}

If the deck's API isn't on http://localhost:3001/api, set MILLION_API in the server's env.

Tools

| Tool | What it does | |---|---| | get_status | running or not, paper or live, feed health, followed wallets, book summary | | get_book | open and closed positions with PnL and exit reasons | | get_decisions | the decision log: signals, trades, shadow trades and skips, each with its reason | | why_not_bought | everything to explain one token: its decisions, check report, positions, rules | | get_rules | trading rules in force | | update_rules | change some rule fields, returns before and after (can't enable live trading) | | get_flows | tokens the followed wallets are accumulating or distributing now | | get_roster_holdings | what the followed wallets still hold, and where they took profit | | check_token | safety checks: authorities, liquidity, holders, deployer, sell simulation, RugCheck | | find_token_buyers | a token's biggest buyers with flags (bots, clusters), to find whales to follow | | import_wallets | add wallets to the roster | | analyze_wallet | a wallet's PnL in SOL, win rate, hold times and flags | | get_wallet | a roster wallet's stored analysis and activity | | set_wallet_subscription | follow or unfollow a wallet |

find_token_buyers and analyze_wallet spend your Helius credits.

Ask things like

• "How's my deck doing?"
• "Why didn't it buy CATE?"
• "Find whales from this token and add the three most consistent ones."
• "Make it only trade when two different owners agree, 0.2 SOL per trade."

Experimental software, provided as is, not financial advice. MIT licensed.