io.github.jamhimself/robinx-mcp
Robinhood Chain (4663) caller accuracy + token intel, graded vs real price since genesis. x402-paid
Open source Repository Open in the app JSON README (API)
About
Robinhood Chain (4663) caller accuracy + token intel, graded vs real price since genesis. x402-paid
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- jamhimself
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.6.1
- Last push
- 2026-09-01T21:48:24Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 04:00:14
- Updated
- 2026-08-29 04:00:14
- Origin id
io.github.jamhimself/robinx-mcp
README
# 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.