
cookin-mcp
io.github.cookinfun/cookin-mcp
Solana and Pump.fun token intelligence: bundles, holder quality, KOLs, deployer history.
Documentation
@cookinfun/mcp
MCP server for the Cookin API: Solana and Pump.fun token intelligence for agents. Ask it who is behind a token before entering, while holding, or after exiting.
Eight tools, paid per call in USDC over x402 with no account, or covered by a Cookin Pro key.
What it answers
- Coordinated wallets. Which wallets act as one group (bundles), how much supply they hold, and how many of those groups are heavy net sellers.
- Holder quality. Share of supply held by wallets that historically pick winners, by quick sellers, by suspicious wallets, and by wallets that nuke charts when they exit.
- KOL positions. Which tracked KOL wallets hold, and how much.
- Wallet reputation. One wallet's lifetime PnL, ROI, win rate, hold times, and smart-money classification.
- Deployer history. Every token a deployer launched, its bond rate, and a survival curve across market cap rungs.
- Ratings. A green, yellow, red or neutral verdict per metric, using the same thresholds as the Cookin UI.
Install
Claude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"cookin": {
"command": "npx",
"args": ["-y", "@cookinfun/mcp"],
"env": { "SOLANA_KEY": "<base58 Solana keypair holding USDC>" }
}
}
}
Cursor
In .cursor/mcp.json:
{
"mcpServers": {
"cookin": {
"command": "npx",
"args": ["-y", "@cookinfun/mcp"],
"env": { "COOKIN_API_KEY": "<Cookin Pro key>" }
}
}
}
Anything else that speaks MCP
SOLANA_KEY=<base58 keypair> npx -y @cookinfun/mcp
Paying
Pick one. The server prints which mode it started in, on stderr.
| Environment | Mode | Cost |
|---|---|---|
SOLANA_KEY | Pay per call with x402 | $0.01 per call, $0.02 for a full token snapshot |
COOKIN_API_KEY | Cookin Pro | 1 SOL per 30 days, 600 requests per minute |
| neither | Unpaid | Every call returns 402 and says how to pay |
SOLANA_KEY is a base58-encoded 64-byte Solana keypair. The wallet needs USDC
only: the facilitator pays the network fee, and a call that errors is never
charged. Mint a Pro key at
cookin.fun/account/api-keys.
Optional:
COOKIN_MAX_PAYMENTcaps what one call may pay. Default$0.05.COOKIN_BASE_URLpoints at another host. Defaulthttps://api.cookin.fun.
Tools
| Tool | Price | Returns |
|---|---|---|
scan_token | $0.02 | Full snapshot for one mint: score, holders, bundles, KOLs, cohorts, signals, ratings |
token_trades | $0.01 | Recent trades, each with the trader's history at that moment |
list_new_tokens | $0.01 | New launches that passed the rug filters |
list_pumping_tokens | $0.01 | Tokens currently pumping |
list_graduated_tokens | $0.01 | Recent graduates |
list_agent_buys | $0.01 | What the top Cookin agents bought most recently |
profile_wallet | $0.01 | One wallet's lifetime trading profile |
deployer_history | $0.01 | Every token one deployer launched |
Spend less: start with one scan_token, and stop if its ratings already answer
the question. fields trims a snapshot at the same price. Deployer history
changes slowly, so cache it.
Remote endpoint
The same tools are served remotely at https://api.cookin.fun/mcp, with
nothing to install. Point an MCP host at that URL. A tool call with no
payment returns the x402 quote in its result; sign it and call again
with the payment in the x_payment argument, or send a Pro key in the
Authorization header.
Use the local package instead when you want the server to hold the wallet and pay for calls by itself.
Reference
- Field-by-field reference: api.cookin.fun/skill.md
- OpenAPI spec: api.cookin.fun/openapi.json
- Docs: cookin.fun/api
Development
npm install
npm test # unit tests, no network
npm run build # tsc to dist/
npm start # run the server over stdio
Releasing
package.json and server.json both carry the version, and the MCP
Registry rejects a mismatch. Bump both, publish to npm first (the
registry reads mcpName from the published package), then publish the
metadata:
npm publish --access public
mcp-publisher login github
mcp-publisher publish
MIT
@cookinfun/mcpnpm install @cookinfun/mcp