cookin-mcp

@cookinfun/mcp

用于 Cookin API 的 MCP 服务：为 Agent 提供 Solana 和 Pump.fun 代币情报。在买入、持有或卖出后，先询问代币背后的情况。

提供八种工具，可通过 x402 按次使用 USDC 付费，无需账户；也可使用 Cookin Pro 密钥付费。

能回答的问题

• 协同钱包。 哪些钱包作为一个群组行动（捆绑），它们持有多少代币供应量，以及其中有多少群组是大量净卖家。
• 持有者质量。 历来能挑中赢家的钱包、快速卖出的钱包、可疑钱包，以及离场时会让走势图暴跌的钱包，各自持有的供应量占比。
• KOL 持仓。 哪些受追踪的 KOL 钱包持有代币，以及持有量。
• 钱包声誉。 单个钱包的生命周期 PnL、ROI、胜率、持仓时间和智能资金分类。
• 部署者历史。 某个部署者发布的所有代币、其债券率，以及各市值阶梯的存活曲线。
• 评级。 每项指标给出绿色、黄色、红色或中性判定，使用与 Cookin UI 相同的阈值。

安装

Claude Desktop

将此内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "cookin": {
      "command": "npx",
      "args": ["-y", "@cookinfun/mcp"],
      "env": { "SOLANA_KEY": "<base58 Solana keypair holding USDC>" }
    }
  }
}

Cursor

在 .cursor/mcp.json 中：

{
  "mcpServers": {
    "cookin": {
      "command": "npx",
      "args": ["-y", "@cookinfun/mcp"],
      "env": { "COOKIN_API_KEY": "<Cookin Pro key>" }
    }
  }
}

其他支持 MCP 的客户端

SOLANA_KEY=<base58 keypair> npx -y @cookinfun/mcp

付费方式

任选一种。服务会在 stderr 中打印启动模式。

环境变量	模式	费用
SOLANA_KEY	通过 x402 按次付费	每次调用 $0.01，完整代币快照 $0.02
COOKIN_API_KEY	Cookin Pro	每 30 天 1 SOL，每分钟 600 次请求
两者皆无	未付费	每次调用都会返回 402，并说明付费方式

SOLANA_KEY 是 Base58 编码的 64 字节 Solana 密钥对。钱包只需持有 USDC： 费用由支付服务商承担，调用出错不会收费。请在 cookin.fun/account/api-keys 创建 Pro 密钥。

可选项：

• COOKIN_MAX_PAYMENT 限制单次调用的最高费用。默认值为 $0.05。
• COOKIN_BASE_URL 指向其他主机。默认值为 https://api.cookin.fun。

工具

工具	价格	返回内容
scan_token	$0.02	单个 mint 的完整快照：评分、持有者、捆绑、KOL、群组、信号、评级
token_trades	$0.01	近期交易，每笔交易都包含交易者在当时的历史记录
list_new_tokens	$0.01	通过 rug 筛选的新代币发行
list_pumping_tokens	$0.01	当前正在拉升的代币
list_graduated_tokens	$0.01	近期毕业的代币
list_agent_buys	$0.01	Cookin 顶尖 Agent 最近买入的代币
profile_wallet	$0.01	单个钱包的完整交易档案
deployer_history	$0.01	单个部署者发布的所有代币

节省费用：先调用一次 scan_token，如果评级已能回答问题，就停止查询。fields 可在价格不变的情况下精简快照。部署者历史变化较慢，因此可以缓存。

远程端点

相同的工具也托管在远程地址 https://api.cookin.fun/mcp，无需安装任何内容。将 MCP 主机指向该 URL 即可。不带付款信息的工具调用会在结果中返回 x402 报价；对其签名后，在 x_payment 参数中附上付款信息再次调用，或在 Authorization 标头中发送 Pro 密钥。

如果你希望服务自行持有钱包并为调用付款，请改用本地软件包。

参考资料

• 字段详解：api.cookin.fun/skill.md
• OpenAPI 规范：api.cookin.fun/openapi.json
• 文档：cookin.fun/api

开发

npm install
npm test          # unit tests, no network
npm run build     # tsc to dist/
npm start         # run the server over stdio

发布

package.json 和 server.json 都包含版本号，MCP Registry 会拒绝版本号不一致的内容。请同时更新两者，先发布到 npm（Registry 会从已发布的软件包中读取 mcpName），然后再发布元数据：

npm publish --access public
mcp-publisher login github
mcp-publisher publish

MIT