hoodgrow-mcp

此软件包已停止维护

状态：已于 2026 年 8 月关闭。 不再维护。它封装的 HoodGrow API 已关闭，因此这里的所有工具现在都会在网络调用时失败——托管服务 https://www.hoodgrow.com/api/mcp 已不存在，npm 软件包也已弃用。

原因

HoodGrow 没有付费客户，生命周期总收入仅为 0.81 美元。原因不在于此软件包：API 提供的几乎所有内容都由 Robinhood 自己的注册表免费发布，也可以直接从链上读取，因此付费副本只是可被免费替代的商品，而只需一次 HTTP 调用就能获得替代品。完整原因请参阅 HoodGrow 的 README。

仍值得一读

这是一个完整且可运行的 MCP 服务：包含 14 个工具，并带有准确的注释（按次付费模式下，idempotentHint 为 false，因为重试调用会再次收费——大多数服务都会错误处理这一点）；还支持 x402 付款、预付额度和在同一个客户端中使用承载令牌身份验证。它曾被列入官方 MCP 注册表，也通过了目录审核。如果你正在构建此类服务，这里的实现仍然适用。

hoodgrow-mcp

面向 HoodGrow Robinhood Chain 股票代币 API 的 MCP（Model Context Protocol）服务——提供实时价格、经公司行动调整的供应量（ERC-8056，可正确处理股票拆分）、Morpho/Uniswap DeFi 深度、公司行动（拆分、股息）、持有者分析、交易价格影响/滑点估算、用于回测的 OHLC 价格蜡烛图、市场异动股、大额交易（“鲸鱼”）动态，以及 Base 主网 B20 原生股票代币注册表，并将其作为工具提供给任何 MCP 客户端（Claude Desktop、Claude Code 等）。基于 hoodgrow SDK 构建——你可以选择通过 x402（Base 上的 USDC）按次付费，或使用承载令牌 API 密钥。

最快方式：使用托管服务（无需安装，无需密钥）

HoodGrow 会为你运行 MCP 服务，地址为 https://www.hoodgrow.com/api/mcp。 所有工具都只能读取数据，因此你可以将助手连接到它，并立即开始提问，无需安装、注册或密钥：

claude mcp add --transport http hoodgrow https://www.hoodgrow.com/api/mcp

或在 mcp.json / claude_desktop_config.json 中配置：

{
  "mcpServers": {
    "hoodgrow": { "type": "http", "url": "https://www.hoodgrow.com/api/mcp" }
  }
}

然后可以向助手询问：

• “Robinhood Chain 上 NVDA 经公司行动调整后的供应量和 24 小时交易量是多少？”
• “未来一周有待处理的股票拆分或股息吗？”
• “今天涨幅最大的股票和金额最大的鲸鱼交易有哪些？”

get_catalog 会列出所有代币及其实时价格、24 小时涨跌幅和调整后供应量，无需密钥即可匿名、无限量查询。按代币代码查询的工具首次调用时需要免费 API 密钥或 x402 付款。匿名访问限制为每个 IP 每分钟 20 次请求；这是为了控制滥用，而非计费，目录查询也受此限制。

此前，按代币代码查询的工具前面设有匿名每日额度。该额度已取消：按调用方 IP 设置的额度对任何通过共享出口发起调用的地址来说都是全新的额度，因此实际上从未让任何人触及付费墙。建议自行运行服务；或者，如果需要通过 x402 按次付费，请使用 npm 软件包：

自行运行（npm — 使用你自己的凭据）

凭据为可选项。 如果未设置任何凭据，服务仍会启动并正常运行： get_catalog 免费且不计量。首次调用其他任何工具时，都会返回 API 的 402 错误，并以可读的工具错误形式说明可选方案。设置以下任一项即可继续：

• 免费 API 密钥，自助获取 — 从 hoodgrow.com/profile 获取 HOODGROW_API_KEY。每天可用额度更高，而且同一 IP 背后的其他人无法消耗你的预算。
• x402，按次付费，无需注册 — 钱包私钥（HOODGROW_PRIVATE_KEY），并在 Base 上为其充值 USDC。付费端点每次调用 $0.05；无每日上限。

此软件包绝不会捆绑共享的 HoodGrow 凭据，因此你可以自行控制支出金额和账单归属。

Claude Desktop / Claude Code

添加到 MCP 配置中（Claude Desktop：claude_desktop_config.json；Claude Code：claude mcp add）：

{
  "mcpServers": {
    "hoodgrow": {
      "command": "npx",
      "args": ["-y", "hoodgrow-mcp"],
      "env": {
        "HOODGROW_PRIVATE_KEY": "0x..."
      }
    }
  }
}

或者改用 API 密钥：

{
  "mcpServers": {
    "hoodgrow": {
      "command": "npx",
      "args": ["-y", "hoodgrow-mcp"],
      "env": {
        "HOODGROW_API_KEY": "..."
      }
    }
  }
}

切勿将真实私钥硬编码在已提交的配置文件中 — 只为该钱包充值你愿意花在此 API 上的金额。

可选：使用 buy_credits 工具购买额度后，在 HOODGROW_PRIVATE_KEY 旁添加 "HOODGROW_USE_CREDITS": "true"，让每个数据工具都使用该额度（仅需支付低廉的钱包签名费），而不是每次调用都通过 x402 付费。请参阅下文“预付额度”。

工具

工具	价格（x402）	说明
get_catalog	免费	所有已列出代币：符号、名称、地址、价格、来源、24h 涨跌幅、经公司行动调整后的供应量，以及全目录待处理和近期公司行动。不含单个代币的 DeFi 数据——请参阅 get_token / get_defi
get_token	$0.05	按符号查询单个代币（例如 NVDA），返回相同字段及其 DeFi 深度
get_corporate_actions	使用上述 get_token/get_catalog	待处理和近期公司行动；传入符号可限定范围，不传则查询所有受追踪的代币
get_defi	$0.05	代币参与的所有 Morpho 市场（作为借款方或抵押品）及其 Uniswap V3 池，而不只是 get_token 中单个最高 APY 数值
get_holders	$0.05	持有者数量趋势、24h 净供应量变化（实际铸造/销毁）及最大持有者集中度（可选 limit，范围为 1-50，默认值为 10）
get_slippage	$0.05	以美元计价的交易（side: "buy" | "sell"）会对价格造成多大影响，按 Uniswap V3 池分别计算——包含 bestPoolAddress/bestEffectivePrice，为你选出最佳池
get_ohlc	$0.05	用于回测的 OHLC 价格蜡烛图（interval: "1h" | "4h" | "1d"，可选 from/to/limit，默认查询最近 30 天）。每根蜡烛图都包含 volumeUsd/swapCount——该代币所有 Uniswap V3 池的美元计价兑换量；对于早于成交量索引器回填窗口的时间段，值为 null
get_base_tokens	$0.05	Base 主网（chain 8453）的 B20 原生权益代币注册表——规模比 get_catalog 小得多。上线前：将代币视为可交易资产前，请先检查其 status——"pre_launch" 表示该代币目前没有价格、DEX 流动性或持有者
get_markets	$0.05	全目录的市场动态：涨幅最高/跌幅最大（24h 涨跌幅）、24h 兑换量最高及 Uniswap V3 流动性（TVL）最深的代币。可选 limit（范围为 1-50，默认值为 10）；市场平稳时，涨幅最高/跌幅最大结果可能为空
get_trades	$0.05	股票代币 Uniswap V3 池中近期的大额（“鲸鱼”）交易，按时间从新到旧排列——每笔交易包含 side（"buy" | "sell"）、美元金额和 txHash。不传 symbol 则返回全局动态；可选 limit（范围为 1-100，默认值为 20）
list_credit_bundles	免费	当前预付额度套餐目录（{id: {priceUsd, creditUsd}}）——无需凭据
buy_credits	一笔 x402 付款	购买一个套餐（bundleId 参数）；需要 HOODGROW_PRIVATE_KEY。结算确认后额度到账——使用 get_credit_balance 查询
get_credit_balance	免费	此钱包当前的额度余额；需要 HOODGROW_PRIVATE_KEY
register_credit_webhook	免费注册，之后按投递的事件计费	注册一个由额度支付费用的公司行动 webhook（url，可选 symbols）；需要 HOODGROW_PRIVATE_KEY。HoodGrow 会将每个 corporate_action.* 事件 POST 到 url，并使用 x-hoodgrow-signature 签名。symbols 用于将投递范围（及每个事件的费用）限定为指定代币——不传则适用于所有代币。返回 webhookSecret（仅显示一次）。Builder 订阅 webhook 需改为在网站上设置

每次调用都会将 API 的 JSON 响应作为工具的文本内容返回。请求失败（符号未知、服务器错误）时，会返回 MCP 工具错误（isError: true），而不会导致服务崩溃。

预付额度

通过 x402 一次性购买美元计价的额度余额（buy_credits），然后设置 HOODGROW_USE_CREDITS=true（同时设置 HOODGROW_PRIVATE_KEY）并 重启服务：之后，上述每个数据工具都会使用低成本、免 Gas 的钱包签名扣除余额， 而不是每次调用都重新进行链上 x402 付款。list_credit_bundles/get_credit_balance 不会扣除任何额度； 只有按量计费的数据工具（get_catalog、get_token 等）和 buy_credits 本身会产生费用。

付款安全

x402 付款涉及真实资金，且不具备幂等性——重试超时的调用可能导致重复付款。HoodGrow 的付费墙始终只要求使用 USDC （0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913），并在 Base 主网上 （eip155:8453）付款至 0x8520B3693a2Cf3c2bEa3a505Af3A9c1b093954c7，每次调用最高 收费 $0.05——底层的 hoodgrow/@x402 依赖项会处理协议级验证，但你需要自行控制为签名钱包 注入多少资金。

速率限制

按调用付费时，默认每个 IP 地址每分钟 30 个请求。

完全没有凭据时，get_catalog 仍会响应——它免费且不受限制——其他所有工具在首次调用时都会返回 402。

使用免费 API 密钥时，每日额度为 40 个单位：

调用	单位	免费层每日调用次数
get_catalog（在一个响应中返回所有代币）	0	不受限制——免费
任意单代币工具	1	40
存活检查	0	不受限制

如果只需要一个代币，仍建议使用 get_token，而非 get_catalog——并不是因为它现在更便宜，而是因为它需要解析的内容少得多， 且会提供该代币的 DeFi 深度信息，而目录不会提供这些信息。

x402 按调用付费完全没有每日上限（每个付费端点 $0.05；目录无论如何都免费），而 Builder 会取消上限，并将每分钟限制提高到 300——请参阅 docs.hoodgrow.com。

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (mocked fetch + real in-memory MCP client/server, no network)

许可证

MIT