hyperD MCP server
✓ VerifiedProvides pre-trade DeFi intelligence, risk scores, and synthesis verdicts using USDC on Base for automated blockchain analysis.
Also known as hyperd-ai/hyperd-mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.1.1
- Last commit
- Jun 9, 2026
- License
- MIT
What is hyperD MCP?
hyperD provides pre-trade DeFi intelligence, risk scores, and synthesis verdicts using USDC on Base for automated blockchain analysis.
Summary generated from the project's README
About hyperD MCP server
Analyzing DeFi risks and obtaining pre-trade intelligence directly within AI clients is what hyperd-mcp enables for blockchain developers and traders. The server provides access to 24 tools, including 17 data and risk endpoints and 6 premium synthesis verdicts that use Claude Haiku 4.5 to generate composed verdicts. Users can perform tasks like checking token security scores, evaluating wallet personas, or requesting yield recommendations.
This server operates locally via Node 20+ and integrates with Claude Desktop, Cursor, Cline, or Zed by using a private key or BIP-39 mnemonic in the environment configuration. It also offers a remote MCP-over-HTTPS option for serverless deployments. Instead of a subscription, the service uses a pay-per-call model where transactions are settled using USDC on the Base network via EIP-3009 authorization. Costs range from $0.005 for gas estimates to $1.50 for a full wallet threat brief. While the first few calls per IP are free, most advanced tools require a wallet with a small USDC balance to cover the automated payments.
What you can do with it
- 1Evaluate token securityAsk your AI assistant to check the security risk score of a specific token before making a trade.
Written from the project's README. Every use case is checked against a quote from it.
How to install hyperD MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall hyperD MCP in Claude Code
$ claude mcp add --env 'HYPERD_WALLET_PRIVATE_KEY=<YOUR_HYPERD_WALLET_PRIVATE_KEY>' hyperd-mcp -- npx -y hyperd-mcpInstall hyperD MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"hyperd-mcp": {
"command": "npx",
"args": [
"-y",
"hyperd-mcp"
],
"env": {
"HYPERD_WALLET_PRIVATE_KEY": "<YOUR_HYPERD_WALLET_PRIVATE_KEY>"
}
}
}
}Install hyperD MCP in VS Code
.vscode/mcp.json
{
"servers": {
"hyperd-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hyperd-mcp"
],
"env": {
"HYPERD_WALLET_PRIVATE_KEY": "<YOUR_HYPERD_WALLET_PRIVATE_KEY>"
}
}
}
}Install hyperD MCP in VS Code CLI
$ code --add-mcp '{"name":"hyperd-mcp","type":"stdio","command":"npx","args":["-y","hyperd-mcp"],"env":{"HYPERD_WALLET_PRIVATE_KEY":"<YOUR_HYPERD_WALLET_PRIVATE_KEY>"}}'Install hyperD MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"hyperd-mcp": {
"command": "npx",
"args": [
"-y",
"hyperd-mcp"
],
"env": {
"HYPERD_WALLET_PRIVATE_KEY": "<YOUR_HYPERD_WALLET_PRIVATE_KEY>"
}
}
}
}Install hyperD MCP in Codex
$ codex mcp add hyperd-mcp --env 'HYPERD_WALLET_PRIVATE_KEY=<YOUR_HYPERD_WALLET_PRIVATE_KEY>' -- npx -y hyperd-mcpInstall hyperD MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.hyperd-mcp] command = "npx" args = ["-y", "hyperd-mcp"] [mcp_servers.hyperd-mcp.env] HYPERD_WALLET_PRIVATE_KEY = "<YOUR_HYPERD_WALLET_PRIVATE_KEY>"
Install hyperD MCP in Gemini CLI
$ gemini mcp add -s user -e 'HYPERD_WALLET_PRIVATE_KEY=<YOUR_HYPERD_WALLET_PRIVATE_KEY>' hyperd-mcp npx -- -y hyperd-mcpInstall hyperD MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"hyperd-mcp": {
"command": "npx",
"args": [
"-y",
"hyperd-mcp"
],
"env": {
"HYPERD_WALLET_PRIVATE_KEY": "<YOUR_HYPERD_WALLET_PRIVATE_KEY>"
}
}
}
}Configuration
HYPERD_WALLET_PRIVATE_KEYRequiredSecret0x-prefixed 32-byte EVM private key for the wallet that pays for hyperD calls in USDC on Base. The wallet must hold USDC (~$5 is plenty for hundreds of decision cycles). The MCP server signs EIP-3009 transfer authorizations per call.
HYPERD_WALLET_MNEMONIC
| Name | Description | |
|---|---|---|
| HYPERD_WALLET_PRIVATE_KEY | 0x-prefixed 32-byte EVM private key for the wallet that pays for hyperD calls in USDC on Base. The wallet must hold USDC (~$5 is plenty for hundreds of decision cycles). The MCP server signs EIP-3009 transfer authorizations per call. | RequiredSecret |
| HYPERD_WALLET_MNEMONIC | — |
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablehyperd-ai/hyperd-mcp is public and reachablegithub.com/hyperd-ai/hyperd-mcp ↗Pass
- Package names this repository as its sourcehyperd-mcp names hyperd-ai/hyperd-mcp as sourcenpmjs.com/package/hyperd-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-06-09github.com/hyperd-ai/hyperd-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from hyperd-mcpPass
- No critical advisory in the package or its dependencies116 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubhyperD MCP Server
Exposes 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.
What it does
Each tool call:
- Sends a request to the corresponding
api.hyperd.aiendpoint - Receives an HTTP 402 with payment requirements
- Signs an EIP-3009 USDC transfer authorization with your wallet
- Retries with the payment header
- Returns the data to the AI assistant
You 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.
Try it free
First 5 calls per IP per 24h are free — no wallet, no signup, no API key. Just curl:
curl "https://api.hyperd.ai/api/balance?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
Lifetime 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 or TypeScript MCP server. The premium synthesis tier ($0.30+) always requires payment — it is not free-tier eligible.
/api/wallet/pnl has a tighter free-tier cap of 1 call/IP/day (heavy upstream).
What you need
- A wallet with at least $0.30 USDC on Base (the seed cost for trying every tool once is ~$0.62)
- The wallet's private key OR 12-word BIP-39 mnemonic
- Node 20+ installed
Install + configure
Step 1 — Generate or use an existing wallet
For testing, use a fresh wallet, not your main one. A simple way:
node -e "const {generatePrivateKey, privateKeyToAccount} = require('viem/accounts'); const pk = generatePrivateKey(); console.log('Address:', privateKeyToAccount(pk).address); console.log('Private key:', pk);"
Send ~$1 of USDC on Base to the printed address.
Step 2 — Claude Desktop
Edit your Claude Desktop config (location: macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"hyperd": {
"command": "npx",
"args": ["-y", "hyperd-mcp"],
"env": {
"HYPERD_WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
}
}
}
}
Restart Claude Desktop. The hyperD tools appear in the conversation tool list.
Step 3 — Try it
Ask Claude in any conversation:
"What's the security score for USDC on Base? Use the hyperd.token.security tool."
Claude calls our endpoint, pays $0.05 from your wallet, returns the result. The whole flow takes ~2 seconds.
Cursor / Cline / Zed
Each 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.
For the full MCP client list and per-client config docs see https://modelcontextprotocol.io/clients.
Local-development install (without npm publish)
If you want to run from source instead of npx:
git clone https://github.com/hyperd-ai/hyperd-mcp.git
cd hyperd-mcp
npm install
npm run build
Then in your Claude Desktop config, point at the local build:
{
"mcpServers": {
"hyperd": {
"command": "node",
"args": ["/full/path/to/hyperd-mcp/dist/server.js"],
"env": {
"HYPERD_WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
}
}
}
}
Available tools
| Tool | Price | What it does |
|---|---|---|
hyperd.balance.get |
$0.01 | Multi-chain ERC-20 + native balance lookup |
hyperd.yield.recommend |
$0.05 | Opinionated DeFi yield recommendation |
hyperd.token.info |
$0.01 | Aggregated token metadata (CoinGecko + DefiLlama) |
hyperd.token.security |
$0.05 | GoPlus-backed security risk score |
hyperd.wallet.risk |
$0.10 | Chainalysis sanctions + GoPlus heuristics |
hyperd.protocol.tvl |
$0.01 | DefiLlama protocol health |
hyperd.gas.estimate |
$0.005 | Gas oracle with tip percentiles |
hyperd.dex.quote |
$0.02 | Multi-aggregator best DEX route |
hyperd.wallet.persona |
$0.10 | Behavioral wallet classification |
hyperd.contract.audit |
$0.10 | Pre-trade contract security composite |
hyperd.governance.summarize |
$0.10 | LLM-summarized DAO proposals |
hyperd.sentiment.token |
$0.05 | Token sentiment from Farcaster |
hyperd.liquidation.risk |
$0.10 | Cross-protocol liquidation risk (Aave V3 / Compound v3 / Spark / Morpho) |
hyperd.wallet.anomaly |
$0.10 | Wallet anomaly detection vs 180-day baseline |
hyperd.wallet.pnl |
$0.05 | Realized + unrealized P&L (FIFO/LIFO/HCFO) |
hyperd.budget.guardian |
$0.01 | Agent USDC spend visibility + cap check |
hyperd.bundle |
$0.20 fixed | Multi-call: 1-10 paid GETs in one settlement |
hyperd.watch.create |
$3.00 prepay | Subscribe to a continuous liquidation watch (HMAC webhooks) |
hyperd.watch.list |
(free for owner) | List your active watches |
hyperd.watch.cancel |
(free for owner) | Cancel one of your watches |
Synthesis tier — composed verdicts (Haiku 4.5, v1.1.0)
Each synthesis tool fans out multiple sub-calls internally and returns a single verdict + inputs + methodology.version + coverage envelope, authored by Claude Haiku 4.5.
| Tool | Price | What it does |
|---|---|---|
hyperd.risk.full_audit |
$0.35 | Composed wallet risk: balance + sanctions + persona + contract + mixer. Bands: safe / moderate / elevated / critical. |
hyperd.token.archetype |
$0.30 | Token classification: stablecoin / blue_chip / mid_cap / memecoin / wrapped / governance / unverified. |
hyperd.wallet.thesis |
$0.50 | Plain-language behavioral thesis: trader / hodler / yield_farmer / mev_bot / compromised / inactive. |
hyperd.wallet.threat_brief |
$1.50 | 2-3 sentence security verdict: clean / watch / elevated / critical. |
hyperd.gov.translate |
$1.00 | Snapshot/Tally proposal in plain language (1y cache). |
hyperd.yield.allocation |
$1.00 | Portfolio split across risk tiers for a given amount (6h cache). |
Full HTTP API docs: https://api.hyperd.ai/api/discover
Security
- Use a hot wallet, not your primary. The MCP server has the private key in process memory while it runs.
- 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.
- Don't commit your private key. The Claude Desktop config file is local; don't share it.
Configuration via mnemonic instead of private key
If you have a 12 or 24-word BIP-39 mnemonic instead of a raw key:
"env": {
"HYPERD_WALLET_MNEMONIC": "word1 word2 ... word12"
}
Derives at the standard Ethereum path m/44'/60'/0'/0/0.
Optional env vars
HYPERD_API_BASE— defaulthttps://api.hyperd.ai. Override for testnet or self-hosted.HYPERD_BASE_RPC— default public Base RPC. Override for higher rate limits.
Remote MCP-over-HTTPS (no install)
If you don't want to run the stdio server locally, hyperD's full tool catalog is also available as a remote MCP server:
POST https://api.hyperd.ai/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}
Same 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.
Useful when:
- You're deploying an agent to a serverless platform (Vercel, Lambda) and don't want to bundle the stdio process
- You're using an MCP-aware service that expects a remote URL (Smithery enterprise, hosted gateways)
- You want to test the API surface from the command line with
curlbefore committing to a local install
Server card: https://api.hyperd.ai/.well-known/mcp.json.
License
MIT — same as the parent repo.
hyperD MCP questions
How do I add hyperD MCP to Claude Code?
Run claude mcp add --env 'HYPERD_WALLET_PRIVATE_KEY=<YOUR_HYPERD_WALLET_PRIVATE_KEY>' hyperd-mcp -- npx -y hyperd-mcp in your terminal. Add --scope user to make it available in every project.
How do I add hyperD MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How much does it cost to use the tools?
Tool costs range from $0.005 to $1.50 in USDC on Base per call, depending on the specific data or synthesis verdict requested.