Operate a self-hosted Solana whale tracker and copy-trading deck to monitor positions, trading rules, and token safety checks.
Also known as Kelows/million, million-mcp
- Stars
- 15
- Tools
- 14
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Sep 14, 2026
- License
- MIT
What is million MCP?
million is an MCP server. Operate a self-hosted Solana whale tracker and copy-trading deck to monitor positions, trading rules, and token safety checks. It exposes 14 tools, such as get_status, get_book, get_decisions.
Summary generated from the project's README
About million MCP server
Monitoring Solana whale movements and managing copy-trading strategies from within your AI development environment is what this server enables. It acts as a thin interface for the million deck, allowing clients like Claude Desktop, Cursor, and VS Code to interact with your local trading setup. Because it connects to a local API, the deck must be running on your machine via npx create-million, and you will need a Helius API key for certain functions.
Developers can use specific tools to inspect the health of their feed, review open or closed positions with PnL, and examine the decision log to understand why trades were executed or skipped. The server provides access to trading rules, roster order flows, and token safety checks including liquidity and rug checks. While you can update rule fields, the server is designed so that no tool can switch your setup from paper trading to live trading mode.
Written from the project's README. Every use case is checked against a quote from it.
How to install million MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall million MCP in Claude Code
$ claude mcp add million -- npx -y million-mcpInstall million MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"million": {
"command": "npx",
"args": [
"-y",
"million-mcp"
]
}
}
}Install million MCP in VS Code
.vscode/mcp.json
{
"servers": {
"million": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"million-mcp"
]
}
}
}Install million MCP in VS Code CLI
$ code --add-mcp '{"name":"million","type":"stdio","command":"npx","args":["-y","million-mcp"]}'Install million MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"million": {
"command": "npx",
"args": [
"-y",
"million-mcp"
]
}
}
}Install million MCP in Codex
$ codex mcp add million -- npx -y million-mcpInstall million MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.million] command = "npx" args = ["-y", "million-mcp"]
Install million MCP in Gemini CLI
$ gemini mcp add -s user million npx -- -y million-mcpInstall million MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"million": {
"command": "npx",
"args": [
"-y",
"million-mcp"
]
}
}
}million MCP tools 14
Detected from the READMEget_statusget_bookget_decisionswhy_not_boughtget_rulesupdate_rulesget_flowsget_roster_holdingscheck_tokenfind_token_buyersimport_walletsanalyze_wallet
| get_status | — | |
| get_book | — | |
| get_decisions | — | |
| why_not_bought | — | |
| get_rules | — | |
| update_rules | — | |
| get_flows | — | |
| get_roster_holdings | — | |
| check_token | — | |
| find_token_buyers | — | |
| import_wallets | — | |
| analyze_wallet | — |
Show all 14 toolsShow fewer tools
get_walletset_wallet_subscription
| get_wallet | — | |
| set_wallet_subscription | — |
Configuration
MILLION_APIAddress of the million deck's local API
| Name | Description | |
|---|---|---|
| MILLION_API | Address of the million deck's local API |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubmillion-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.
million MCP questions
How do I add million MCP to Claude Code?
Run claude mcp add million -- npx -y million-mcp in your terminal. Add --scope user to make it available in every project.
How do I add million MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does million MCP provide?
It exposes 14 tools, including get_status, get_book, get_decisions, why_not_bought, get_rules.
Does this server allow live trading?
No, the server is a thin layer over a local API and no tool can switch paper trading to live.
What do I need to run the million deck?
You need Node 24 or nvm and a free Helius API key.
Can I change my trading rules using the AI?
Yes, you can update rule fields, though it cannot enable live trading.
How do I connect to a non-default API port?
If your deck's API is not on the default localhost:3001/api, you can set the MILLION_API environment variable.