HoodScope MCP

Model Context Protocol server for HoodScope — deployer reputation, insider detection, and token buy-risk verdicts for Robinhood Chain (chain 4663) memecoins, built from complete on-chain history. Gives any MCP agent (Claude Desktop, Cursor, …) a one-hop answer to "who launched this token and should I trust it?" — even seconds after launch, because it scores the deployer, not just the contract.

Paid tools settle $0.01–0.02 USDC per call on Base via the x402 protocol. Configure a funded wallet key and the agent pays automatically; leave it out and paid tools return the price instead of data.

Tools

Tool	Price	What it does
hoodscope_verdict	$0.02	Composite buy-risk verdict: deployer reputation + insider-distribution flags + activity → trusted / mixed / avoid / serial_spammer / new_deployer with reasons
hoodscope_deployer	$0.01	Deployer rap sheet: launched / real / dead counts, best-token volume, insider flag, 0-100 score
hoodscope_token	$0.01	Token stats: swaps, WETH volume, unique traders, real-or-thin, linked deployer score
hoodscope_leaderboard	$0.01	Top trusted deployers on the chain
hoodscope_stats	free	Coverage stats (discovery)

Install — Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "hoodscope": {
      "command": "npx",
      "args": ["-y", "hoodscope-mcp"],
      "env": {
        "HOODSCOPE_WALLET_KEY": "0xYOUR_FUNDED_BASE_USDC_WALLET_PRIVATE_KEY"
      }
    }
  }
}

Install — Cursor

Add to ~/.cursor/mcp.json (or a project .cursor/mcp.json) with the same command/args/env block.

Config (env)

var	required	default	purpose
HOODSCOPE_WALLET_KEY	for paid tools	—	Private key of a funded Base wallet holding USDC. Without it, paid tools return the price and setup note instead of data.
HOODSCOPE_MAX_USD_PER_CALL	no	0.10	Hard per-call spend ceiling; a requirement above this is refused.
HOODSCOPE_URL	no	production	Override the API base URL.

Security: the wallet key only ever touches this local MCP process; it is never sent to the API (x402 signs locally, the facilitator settles). Use a dedicated low-balance wallet.

Without a wallet

Every paid tool still works as a price probe: it returns PAYMENT REQUIRED ($0.0X USDC) plus the x402 requirements, so an agent can decide whether to pay. The free hoodscope_stats tool always works.

Run locally (development)

npm install
HOODSCOPE_WALLET_KEY=0x... node server.js   # stdio server

API: https://hoodscope-api-production.up.railway.app · x402 settlement proven on Base.