{
  "markdown": "> ## This package is retired\n>\n> **Status: closed, August 2026.** Not maintained. The HoodGrow API it wraps is\n> shut down, so every tool here now fails at the network call — the hosted\n> server at `https://www.hoodgrow.com/api/mcp` is gone and the npm package is\n> deprecated.\n>\n> ### Why\n>\n> HoodGrow had no paying customers and $0.81 of lifetime revenue. The cause was\n> not this package: almost everything the API served is published free by\n> Robinhood's own registry and readable straight off the chain, so a paid copy\n> was a commodity with a free substitute one HTTP call away. See\n> [HoodGrow's README](https://github.com/MeMikko/HoodGrow) for the full\n> reasoning.\n>\n> ### Still worth reading\n>\n> This is a complete, working MCP server: 14 tools with honest annotations\n> (`idempotentHint` is `false` in pay-per-call mode, because a retried call\n> charges again — a detail most servers get wrong), x402 payment, prepaid\n> credits and bearer auth in one client. It was listed in the official MCP\n> registry and passed directory review. If you are building one, the parts\n> here work.\n\n# hoodgrow-mcp\n\n[![M8ven Verified](https://m8ven.ai/badge/mcp/memikko-hoodgrow-mcp-1ir3oo)](https://m8ven.ai/mcp/memikko-hoodgrow-mcp-1ir3oo)\n[![hoodgrow-mcp MCP server](https://glama.ai/mcp/servers/MeMikko/hoodgrow-mcp/badges/score.svg)](https://glama.ai/mcp/servers/MeMikko/hoodgrow-mcp)\n\nMCP ([Model Context Protocol](https://modelcontextprotocol.io)) server for the\n[HoodGrow](https://www.hoodgrow.com) Robinhood Chain stock token API — live\nprice, corporate-action adjusted supply (ERC-8056, correct through stock\nsplits), Morpho/Uniswap DeFi depth, corporate actions (splits, dividends),\nholder analytics, trade price-impact/slippage estimates, OHLC price\ncandles for backtesting, market movers, a large-trade (\"whale\") feed,\nand a Base mainnet B20 native-equity-token registry, exposed as tools for\nany MCP client (Claude Desktop, Claude Code, etc). Built on the\n[`hoodgrow`](https://github.com/MeMikko/hoodgrow-ts) SDK — pays per call via\n**x402** (USDC on Base) or uses a bearer API key, your choice.\n\n## Fastest: the hosted server (no install, no key)\n\nHoodGrow runs the MCP server for you at **`https://www.hoodgrow.com/api/mcp`**.\nEvery tool is read-only, so you can point an assistant at it and start asking\nwith **no install, no signup, no key**:\n\n```bash\nclaude mcp add --transport http hoodgrow https://www.hoodgrow.com/api/mcp\n```\n\nor in `mcp.json` / `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"hoodgrow\": { \"type\": \"http\", \"url\": \"https://www.hoodgrow.com/api/mcp\" }\n  }\n}\n```\n\nThen ask your assistant things like:\n\n- *\"What's the corporate-action adjusted supply and 24h volume for NVDA on Robinhood Chain?\"*\n- *\"Any pending stock splits or dividends in the next week?\"*\n- *\"Top gainers and biggest whale trades today.\"*\n\n`get_catalog` — every listed token with live price, 24h change and adjusted\nsupply — answers anonymously and unmetered, no key at all. The per-symbol\ntools ask for a free API key or an x402 payment on the first call. Anonymous\naccess is capped at 20 requests/minute per IP, which is abuse shaping rather\nthan billing and applies to the catalog too.\n\nThere used to be an anonymous daily budget in front of the per-symbol tools.\nIt is gone: a budget keyed on the caller's IP is a fresh budget per address\nto anything calling from pooled egress, so it never actually led anyone to\nthe paywall. Prefer running the server yourself, or need x402 pay-per-call?\nUse the npm package instead:\n\n## Run it yourself (npm — your own credentials)\n\n**Credentials are optional.** With none set, the server starts and works:\n`get_catalog` is free and unmetered. Every other tool returns the API's 402\non its first call, as a readable tool error naming the alternatives. Set one\nof these to get past it:\n\n- **API key, free, self-serve** — `HOODGROW_API_KEY` from\n  [hoodgrow.com/profile](https://www.hoodgrow.com/profile). A larger daily\n  allowance, and a budget nobody behind the same IP can spend.\n- **x402, pay per call, no signup** — a wallet private key (`HOODGROW_PRIVATE_KEY`),\n  funded with USDC on Base. $0.05/call for the paid endpoints; no daily cap.\n\nThis package never bundles a shared HoodGrow credential, so you control what\ngets spent and who's billed.\n\n### Claude Desktop / Claude Code\n\nAdd to your MCP config (Claude Desktop: `claude_desktop_config.json`; Claude\nCode: `claude mcp add`):\n\n```json\n{\n  \"mcpServers\": {\n    \"hoodgrow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"hoodgrow-mcp\"],\n      \"env\": {\n        \"HOODGROW_PRIVATE_KEY\": \"0x...\"\n      }\n    }\n  }\n}\n```\n\nOr with an API key instead:\n\n```json\n{\n  \"mcpServers\": {\n    \"hoodgrow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"hoodgrow-mcp\"],\n      \"env\": {\n        \"HOODGROW_API_KEY\": \"...\"\n      }\n    }\n  }\n}\n```\n\nNever hardcode a real private key in a committed config file — only fund\nthat wallet with what you're willing to spend on this API.\n\nOptionally, once you've bought a credit balance with the `buy_credits` tool,\nadd `\"HOODGROW_USE_CREDITS\": \"true\"` alongside `HOODGROW_PRIVATE_KEY` to\nhave every data tool spend that balance (a cheap wallet signature) instead\nof paying x402 per call. See \"Prepaid credits\" below.\n\n## Tools\n\n| Tool | Price (x402) | Description |\n| --- | --- | --- |\n| `get_catalog` | **free** | Every listed token: symbol, name, address, price, source, 24h change, corporate-action adjusted supply, plus catalog-wide pending/recent corporate actions. No per-token DeFi — see `get_token` / `get_defi` |\n| `get_token` | $0.05 | One token by symbol (e.g. `NVDA`), same fields plus its DeFi depth |\n| `get_corporate_actions` | uses `get_token`/`get_catalog` above | Pending + recent corporate actions; pass a symbol to scope, omit for every tracked token |\n| `get_defi` | $0.05 | Every Morpho market a token participates in (loan OR collateral role) plus its Uniswap V3 pools — not just the single best-APY figure in `get_token` |\n| `get_holders` | $0.05 | Holder-count trend, 24h net supply change (real mint/burn), and top-holder concentration (optional `limit`, 1-50, defaults to 10) |\n| `get_slippage` | $0.05 | How much a USD-sized trade (`side: \"buy\" \\| \"sell\"`) would move the price, per Uniswap V3 pool — includes `bestPoolAddress`/`bestEffectivePrice` picking the best one for you |\n| `get_ohlc` | $0.05 | OHLC price candles for backtesting (`interval: \"1h\" \\| \"4h\" \\| \"1d\"`, optional `from`/`to`/`limit`, defaults to the last 30 days). Each candle carries `volumeUsd`/`swapCount` — USD swap volume across the token's Uniswap V3 pools — `null` for buckets older than the volume indexer's backfill window |\n| `get_base_tokens` | $0.05 | Base mainnet (chain 8453) B20 native-equity-token registry — a much smaller sibling of `get_catalog`. **Pre-launch**: check each token's `status` before treating it as tradable — `\"pre_launch\"` means no price, no DEX liquidity, no holders exist for it yet |\n| `get_markets` | $0.05 | Market movers across the whole catalog: top gainers/losers (24h change), highest 24h swap volume, and deepest Uniswap V3 liquidity (TVL). Optional `limit` (1-50, default 10); gainers/losers can be empty on a flat market |\n| `get_trades` | $0.05 | Recent large (\"whale\") trades in the stock-token Uniswap V3 pools, newest first — each with `side` (`\"buy\" \\| \"sell\"`), USD size, and `txHash`. Omit `symbol` for the global feed; optional `limit` (1-100, default 20) |\n| `list_credit_bundles` | free | Current prepaid credit bundle catalog (`{id: {priceUsd, creditUsd}}`) — no credentials needed |\n| `buy_credits` | one x402 payment | Pays for one bundle (`bundleId` arg); requires `HOODGROW_PRIVATE_KEY`. Balance lands once settlement confirms — check with `get_credit_balance` |\n| `get_credit_balance` | free | This wallet's current credit balance; requires `HOODGROW_PRIVATE_KEY` |\n| `register_credit_webhook` | free to register, then per delivered event | Register a credit-funded corporate-action webhook (`url`, optional `symbols`); requires `HOODGROW_PRIVATE_KEY`. HoodGrow POSTs each `corporate_action.*` event to `url`, signed `x-hoodgrow-signature`. `symbols` restricts delivery (and per-event billing) to those tokens — omit for all. Returns `webhookSecret` (shown once). Builder-subscription webhooks are set from the website instead |\n\nEach call returns the API's JSON response as the tool's text content. A\nfailed request (unknown symbol, server error) comes back as an MCP tool\nerror (`isError: true`) rather than crashing the server.\n\n## Prepaid credits\n\nBuy a dollar-denominated credit balance once via x402 (`buy_credits`), then\nset `HOODGROW_USE_CREDITS=true` (alongside `HOODGROW_PRIVATE_KEY`) and\nrestart the server: every data tool above then spends the balance with a\ncheap, gas-free wallet signature instead of a fresh on-chain x402 payment\nper call. `list_credit_bundles`/`get_credit_balance` never spend anything;\nonly the metered data tools (`get_catalog`, `get_token`, etc.) and\n`buy_credits` itself move money.\n\n## Payment safety\n\nx402 payments are real money and are **not** idempotent — a retried timed-out\ncall can pay twice. HoodGrow's paywall only ever asks for USDC\n(`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`) on Base mainnet\n(`eip155:8453`), paid to `0x8520B3693a2Cf3c2bEa3a505Af3A9c1b093954c7`, capped\nat $0.05/call — the underlying `hoodgrow`/`@x402` dependencies handle\nprotocol-level verification, but you're responsible for how much you fund\nthe signing wallet with.\n\n## Rate limits\n\n30 requests/minute per IP by default for pay-per-call use.\n\nWith **no credentials at all**, `get_catalog` still answers — it is free and\nunmetered — and every other tool returns a 402 on the first call.\n\nWith a **free API key**, the daily allowance is 40 units:\n\n| Call | Units | Free-tier calls/day |\n|---|---|---|\n| `get_catalog` (every token in one response) | 0 | unmetered — it is free |\n| Any single-symbol tool | 1 | 40 |\n| Liveness check | 0 | unmetered |\n\nStill prefer `get_token` over `get_catalog` when you want one symbol — not\nbecause it is cheaper now, but because it returns far less to parse and\ncarries that token's DeFi depth, which the catalog does not.\n\n**x402 pay-per-call** has no daily cap at all ($0.05 per paid endpoint; the\ncatalog is free either way), and **Builder** removes the cap and raises the\nper-minute limit to 300 — see [docs.hoodgrow.com](https://docs.hoodgrow.com).\n\n## Development\n\n```bash\nnpm install\nnpm run build   # tsc -> dist/\nnpm test        # tsx --test test/*.test.ts (mocked fetch + real in-memory MCP client/server, no network)\n```\n\n## License\n\nMIT\n",
  "bytes": 10606,
  "sha": "6393f5287a181fac1a1026a2a48761d341042f350f982cb887950307ce07c1c1",
  "repo_slug": "memikko/hoodgrow-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_memikko_hoodgrow_mcp_91ee260e/readme"
}