{
  "markdown": "# hyperD MCP Server\n\nExposes 24 paid hyperD x402 tools — 17 data/risk endpoints, **6 premium synthesis verdicts** ($0.30–$1.50), and a multi-call bundle — plus 3 free meta tools (and 3 watch tools when enabled) from `api.hyperd.ai`. Drop into Claude Desktop, Cursor, Cline, Zed, or any MCP-compatible client.\n\n## What it does\n\nEach tool call:\n1. Sends a request to the corresponding `api.hyperd.ai` endpoint\n2. Receives an HTTP 402 with payment requirements\n3. Signs an EIP-3009 USDC transfer authorization with your wallet\n4. Retries with the payment header\n5. Returns the data to the AI assistant\n\nYou pay **$0.005–$1.50 in USDC on Base** per call — data/risk endpoints $0.005–$0.10, premium synthesis verdicts $0.30–$1.50. No subscription. No accounts.\n\n## Try it free\n\nFirst 5 calls per IP per 24h are free — no wallet, no signup, no API key. Just curl:\n\n```bash\ncurl \"https://api.hyperd.ai/api/balance?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"\n```\n\nLifetime cap: 10 calls per IP. After that (or when daily quota is exhausted), the endpoint returns HTTP 402 — sign a small EIP-3009 USDC payment on Base via the [Python SDK](https://pypi.org/project/hyperd-ai/) or [TypeScript MCP server](https://www.npmjs.com/package/hyperd-mcp). The premium synthesis tier ($0.30+) always requires payment — it is not free-tier eligible.\n\n`/api/wallet/pnl` has a tighter free-tier cap of 1 call/IP/day (heavy upstream).\n\n## What you need\n\n- A wallet with **at least $0.30 USDC on Base** (the seed cost for trying every tool once is ~$0.62)\n- The wallet's private key OR 12-word BIP-39 mnemonic\n- Node 20+ installed\n\n## Install + configure\n\n### Step 1 — Generate or use an existing wallet\n\nFor testing, **use a fresh wallet, not your main one.** A simple way:\n\n```bash\nnode -e \"const {generatePrivateKey, privateKeyToAccount} = require('viem/accounts'); const pk = generatePrivateKey(); console.log('Address:', privateKeyToAccount(pk).address); console.log('Private key:', pk);\"\n```\n\nSend ~$1 of USDC on Base to the printed address.\n\n### Step 2 — Claude Desktop\n\nEdit your Claude Desktop config (location: macOS `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows `%APPDATA%\\Claude\\claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperd\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"hyperd-mcp\"],\n      \"env\": {\n        \"HYPERD_WALLET_PRIVATE_KEY\": \"0xYOUR_PRIVATE_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The hyperD tools appear in the conversation tool list.\n\n### Step 3 — Try it\n\nAsk Claude in any conversation:\n\n> \"What's the security score for USDC on Base? Use the hyperd.token.security tool.\"\n\nClaude calls our endpoint, pays $0.05 from your wallet, returns the result. The whole flow takes ~2 seconds.\n\n### Cursor / Cline / Zed\n\nEach MCP-compatible client has a similar config file. Same pattern: name the server `hyperd`, command is `npx -y hyperd-mcp`, set `HYPERD_WALLET_PRIVATE_KEY` env var.\n\nFor the full MCP client list and per-client config docs see https://modelcontextprotocol.io/clients.\n\n## Local-development install (without npm publish)\n\nIf you want to run from source instead of `npx`:\n\n```bash\ngit clone https://github.com/hyperd-ai/hyperd-mcp.git\ncd hyperd-mcp\nnpm install\nnpm run build\n```\n\nThen in your Claude Desktop config, point at the local build:\n\n```json\n{\n  \"mcpServers\": {\n    \"hyperd\": {\n      \"command\": \"node\",\n      \"args\": [\"/full/path/to/hyperd-mcp/dist/server.js\"],\n      \"env\": {\n        \"HYPERD_WALLET_PRIVATE_KEY\": \"0xYOUR_PRIVATE_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n## Available tools\n\n| Tool | Price | What it does |\n|---|---|---|\n| `hyperd.balance.get` | $0.01 | Multi-chain ERC-20 + native balance lookup |\n| `hyperd.yield.recommend` | $0.05 | Opinionated DeFi yield recommendation |\n| `hyperd.token.info` | $0.01 | Aggregated token metadata (CoinGecko + DefiLlama) |\n| `hyperd.token.security` | $0.05 | GoPlus-backed security risk score |\n| `hyperd.wallet.risk` | $0.10 | Chainalysis sanctions + GoPlus heuristics |\n| `hyperd.protocol.tvl` | $0.01 | DefiLlama protocol health |\n| `hyperd.gas.estimate` | $0.005 | Gas oracle with tip percentiles |\n| `hyperd.dex.quote` | $0.02 | Multi-aggregator best DEX route |\n| `hyperd.wallet.persona` | $0.10 | Behavioral wallet classification |\n| `hyperd.contract.audit` | $0.10 | Pre-trade contract security composite |\n| `hyperd.governance.summarize` | $0.10 | LLM-summarized DAO proposals |\n| `hyperd.sentiment.token` | $0.05 | Token sentiment from Farcaster |\n| `hyperd.liquidation.risk` | $0.10 | Cross-protocol liquidation risk (Aave V3 / Compound v3 / Spark / Morpho) |\n| `hyperd.wallet.anomaly` | $0.10 | Wallet anomaly detection vs 180-day baseline |\n| `hyperd.wallet.pnl` | $0.05 | Realized + unrealized P&L (FIFO/LIFO/HCFO) |\n| `hyperd.budget.guardian` | $0.01 | Agent USDC spend visibility + cap check |\n| `hyperd.bundle` | $0.20 fixed | Multi-call: 1-10 paid GETs in one settlement |\n| `hyperd.watch.create` | $3.00 prepay | Subscribe to a continuous liquidation watch (HMAC webhooks) |\n| `hyperd.watch.list` | (free for owner) | List your active watches |\n| `hyperd.watch.cancel` | (free for owner) | Cancel one of your watches |\n\n### Synthesis tier — composed verdicts (Haiku 4.5, v1.1.0)\n\nEach synthesis tool fans out multiple sub-calls internally and returns a single `verdict` + `inputs` + `methodology.version` + `coverage` envelope, authored by Claude Haiku 4.5.\n\n| Tool | Price | What it does |\n|---|---|---|\n| `hyperd.risk.full_audit` | $0.35 | Composed wallet risk: balance + sanctions + persona + contract + mixer. Bands: safe / moderate / elevated / critical. |\n| `hyperd.token.archetype` | $0.30 | Token classification: stablecoin / blue_chip / mid_cap / memecoin / wrapped / governance / unverified. |\n| `hyperd.wallet.thesis` | $0.50 | Plain-language behavioral thesis: trader / hodler / yield_farmer / mev_bot / compromised / inactive. |\n| `hyperd.wallet.threat_brief` | $1.50 | 2-3 sentence security verdict: clean / watch / elevated / critical. |\n| `hyperd.gov.translate` | $1.00 | Snapshot/Tally proposal in plain language (1y cache). |\n| `hyperd.yield.allocation` | $1.00 | Portfolio split across risk tiers for a given amount (6h cache). |\n\nFull HTTP API docs: https://api.hyperd.ai/api/discover\n\n## Security\n\n- **Use a hot wallet**, not your primary. The MCP server has the private key in process memory while it runs.\n- **Cap your spend** by transferring only what you want to use. There's no built-in spending limit; the wallet's balance IS the limit.\n- **Don't commit your private key.** The Claude Desktop config file is local; don't share it.\n\n## Configuration via mnemonic instead of private key\n\nIf you have a 12 or 24-word BIP-39 mnemonic instead of a raw key:\n\n```json\n\"env\": {\n  \"HYPERD_WALLET_MNEMONIC\": \"word1 word2 ... word12\"\n}\n```\n\nDerives at the standard Ethereum path `m/44'/60'/0'/0/0`.\n\n## Optional env vars\n\n- `HYPERD_API_BASE` — default `https://api.hyperd.ai`. Override for testnet or self-hosted.\n- `HYPERD_BASE_RPC` — default public Base RPC. Override for higher rate limits.\n\n## Remote MCP-over-HTTPS (no install)\n\nIf you don't want to run the stdio server locally, hyperD's full tool catalog is also available as a remote MCP server:\n\n```\nPOST https://api.hyperd.ai/mcp\nContent-Type: application/json\n\n{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}\n```\n\nSame 24 paid tools, same free-tier quota (5 calls/IP/day, 10 lifetime), same `X-Payment` auth model for paid calls after quota. No `npm install`, no per-IDE config — just a URL.\n\nUseful when:\n- You're deploying an agent to a serverless platform (Vercel, Lambda) and don't want to bundle the stdio process\n- You're using an MCP-aware service that expects a remote URL (Smithery enterprise, hosted gateways)\n- You want to test the API surface from the command line with `curl` before committing to a local install\n\nServer card: [`https://api.hyperd.ai/.well-known/mcp.json`](https://api.hyperd.ai/.well-known/mcp.json).\n\n## License\n\nMIT — same as the parent repo.\n",
  "bytes": 8022,
  "sha": "7a66a274bebd0c434d3434aafa98c7ad82e8ffb4344910310b4ba86d3852542d",
  "repo_slug": "hyperd-ai/hyperd-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hyperd_ai_hyperd_mcp_c5279ec1/readme"
}