cortexcloud

@cortexcloud.org/mcp

面向 CortexCloud 的 MCP 服务——为 AI Agent 提供按次付费的链上数据和情报。支持查询代币、钱包、风险、巨鲸、余额、NFT、交易和跨链数据，通过 x402 在 Base 上使用 USDC 结算。无需 API 密钥、订阅或注册。

两种连接方式

**1. 远程（推荐）。**托管服务使用 Streamable HTTP，始终保持最新：

{
  "mcpServers": {
    "cortexcloud": {
      "type": "http",
      "url": "https://api.cortexcloud.org/mcp"
    }
  }
}

**2. stdio 桥接。**本软件包适用于只能启动本地进程的客户端：

{
  "mcpServers": {
    "cortexcloud": {
      "command": "npx",
      "args": ["-y", "@cortexcloud.org/mcp"]
    }
  }
}

该桥接器是传输适配器，而非另一套实现：它会将 tools/list 和 tools/call 转发到托管服务，因此工具、架构和价格始终与 API 一致。

工具

共 17 个工具，来自实时注册表：

• 付费（15 个） — cortex_token_intel（$0.030）、cortex_cross_chain_compare（$0.040）、cortex_whale_alerts（$0.030）、cortex_token_risk（$0.020）、cortex_wallet_intel（$0.006），以及价格为 $0.004 的数据路由：cortex_token_price、cortex_token_balances、cortex_nft_ownership、cortex_tx_history、cortex_gas_oracle、cortex_block，以及批量工具 cortex_aggregate_balances、cortex_aggregate_nfts、cortex_aggregate_prices、cortex_aggregate_tx_history（每次调用最多处理 20 项）。
• 免费（2 个） — cortex_capabilities（列出所有路由、链和价格）和 cortex_prices（价格表）。

权威列表始终可通过 GET https://api.cortexcloud.org/v1/capabilities 获取，也可通过 MCP 调用 cortex_capabilities 获取。

付款方式

调用付费工具但未付款时，工具结果中会返回 x402 挑战，其中包含价格、收款方、资产、网络和待调用端点。读取挑战不会产生费用，也不需要钱包。

要完成结算，调用方需签署 EIP-3009 USDC 授权，并使用 payment-signature 标头重放请求。通过 MCP 调用时，服务会将该标头原样转发给 API；它不持有资金，也不会签名。使用 stdio 时，可通过以下方式转发已有签名：

CORTEXCLOUD_PAYMENT_SIGNATURE=<base64 header> npx -y @cortexcloud.org/mcp

如需通过代码完成完整的付费流程，请使用 REST 参考客户端——在一个文件中实现 402 -> sign -> 200：

https://api.cortexcloud.org/examples/paid_client.py

环境变量

变量	默认值	含义
CORTEXCLOUD_BASE	https://api.cortexcloud.org	API 根地址；桥接器连接到 <base>/mcp
CORTEXCLOUD_PAYMENT_SIGNATURE	—	可选的 x402 付款标头，会在每次调用时转发

已验证行为

• initialize 会声明协议版本 2025-06-18；上游服务报告的版本为 0.5.0。
• tools/list 会返回 17 个工具。
• cortex_capabilities 无需付款即可返回实时目录。
• 未付款调用 cortex_token_price 时会返回 402 挑战，而非错误。

链接

• API 和文档：https://api.cortexcloud.org/docs
• 发现： x402.json · bazaar · llms.txt
• 延迟和价格：https://api.cortexcloud.org/benchmarks.html

采用 MIT 许可证。