robinx-mcp

# 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\`):

```json
{
  "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)

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

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