Hyperd MCP server
io.github.hyperd-ai/hyperd-mcp·v1.1.1·1 starsPre-trade DeFi intelligence: 24 paid x402 tools incl. 6 synthesis verdicts, USDC on Base.
1 stars54 downloads/wk
Reviews
Write oneNobody has reviewed Hyperd yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Hyperd tools (29, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
hyperd.balance.getGet the on-chain balance for an EVM wallet address. Multi-chain (Base, Ethereum, Polygon, Arbitrum). Supports ERC-20 by symbol or contract address. Pass chain='all' for parallel multi-chain lookup. Costs $0.01 in USDC on Base.
hyperd.budget.guardianAgent spend visibility: aggregates recent outbound USDC transfers from a wallet over a configurable window (1h/24h/7d/30d). Returns total spend, by-destination breakdown, projected-24h rate, and an optional under_cap flag if cap_usd is provided. Use this BEFORE initiating the next paid x402 call to enforce a self-imposed budget. Bridged USDC.e variants are NOT counted. Costs $0.01 in USDC.
hyperd.bundleBundle multiple paid GET calls into one x402 settlement. Up to 10 sub-calls executed in parallel (concurrency cap 4), per-call results returned in a structured envelope. Fixed $0.20 USDC — typically cheaper than à la carte for any combination summing > $0.24 individually. Best-effort execution: failed sub-calls don't refund in v1.0 (credit ledger planned for v1.1). Use this when you need 3+ paid c
hyperd.catalog.listList all available hyperD x402 API endpoints with their prices, descriptions, and example responses. FREE — no wallet required. Use this to discover what tools are available before configuring a wallet.
hyperd.contract.auditPre-trade contract security audit. Composes GoPlus + Sourcify + DefiLlama protocol recognition + on-chain heuristics into a single 0-100 risk score with structured findings. Use BEFORE interacting with any unfamiliar contract. Costs $0.10 in USDC.
hyperd.dex.quoteGet the best DEX swap route across multiple aggregators (Paraswap + 0x). Returns the highest output amount and per-source quotes. Costs $0.02 in USDC.
hyperd.gas.estimateGet current gas price + base fee + tip percentiles for fast/standard/slow inclusion. Costs $0.005 in USDC.
hyperd.gov.translateComposed DAO governance translator. Takes a Snapshot or Tally proposal URL, fetches structured data via /api/governance/summarize, then produces a 2-3 sentence plain-language translation + domain band (economic_param / treasury / code_upgrade / governance_meta / social_signal). 1-year cache — proposals are immutable. Costs $1.00 in USDC.
hyperd.governance.summarizeSummarize a DAO governance proposal (Snapshot or Tally URL). Returns structured impact analysis: who benefits, who pays, recommended position. LLM-summarized. Costs $0.10 in USDC.
hyperd.health.checkCheck the health of the hyperD API: which network it's on, whether the payment facilitator is configured, which optional backend keys are wired, and cache stats. FREE — no wallet required.
hyperd.liquidation.riskCross-protocol liquidation risk for a wallet's lending positions. Health factor, USD-at-risk, and recommendations across Aave V3, Compound v3, Spark Lend, and Morpho Blue. Pass chain='all' for cross-chain aggregate. Costs $0.10 in USDC.
hyperd.pricing.getGet the current price list for all hyperD paid endpoints (in USDC on Base). FREE — no wallet required.
hyperd.protocol.tvlGet a DeFi protocol's TVL, audits, chain distribution from DefiLlama. Pass slug for detail (e.g., 'aave', 'morpho-blue') or list=true for top 50. Costs $0.01 in USDC.
hyperd.risk.full_auditComposed wallet risk verdict. Fans out to balance, wallet_risk, wallet_persona, contract_audit, and privacy_mixer_risk then returns a Haiku 4.5-authored summary + confidence + band (safe / moderate / elevated / critical). One verdict replaces a manual 5-call audit walk. Costs $0.35 in USDC.
hyperd.sentiment.tokenGet a token's sentiment score (0-100) from recent Farcaster discussion. Returns score, band (very_negative to very_positive), volume, trend, sample casts. Costs $0.05 in USDC.
hyperd.token.archetypeComposed token classification. Fans out to token_info, token_security, and protocol_tvl then returns a single archetype (stablecoin / blue_chip / mid_cap / memecoin / wrapped / governance / unverified) plus a plain-language verdict. Costs $0.30 in USDC.
hyperd.token.infoGet aggregated token metadata: market cap, supply, contract addresses across chains, recent volume. One call replaces multiple CoinGecko / Etherscan / DefiLlama lookups. Costs $0.01 in USDC.
hyperd.token.securityGet a token's security risk score (0-100). Ensemble of GoPlus signals: honeypot detection, owner permissions, holder concentration, buy/sell taxes, source verification. Returns score, band (safe/caution/warning/danger), and structured findings. Costs $0.05 in USDC.
hyperd.wallet.anomalyWallet behavioral anomaly detection. Compares recent activity against the wallet's own 180-day baseline — surfaces tx-volume spikes, dormant-wakeup patterns, new-protocol interactions, counterparty diversification. Catches compromised hot wallets, dormant whales, MEV-bot strategy shifts. Costs $0.10 in USDC.
hyperd.wallet.personaClassify a wallet's persona based on on-chain behavior. Returns one of: Trader, HODLer, MEV-bot, Whale, Smart-Money, Airdrop-Farmer, Compromised, Inactive — plus confidence and supporting signals. Costs $0.10 in USDC.
hyperd.wallet.pnlRealized + unrealized P&L for a wallet over a time window. ERC-20 + native, single chain per call. Three cost-basis methods: FIFO (default, IRS standard), LIFO (last-in-first-out), HCFO (highest-cost-first-out, tax-loss-harvesting view). Per-token breakdown with weighted-avg cost + mark-to-market. Unpriced trades and untracked-proceeds gaps surfaced honestly under coverage.* fields. v1.0 defers pe
hyperd.wallet.riskCheck a wallet's risk profile. Combines Chainalysis Sanctions Oracle (OFAC SDN authoritative) with GoPlus address heuristics (mixers, phishing, scams). Returns sanctioned flag + 0-100 heuristic score. Costs $0.10 in USDC.
hyperd.wallet.thesisComposed wallet behavioral thesis. Fans out to balance, wallet_persona, wallet_pnl, and wallet_anomaly then returns a plain-language summary of the wallet's investing posture plus archetype (trader / hodler / yield_farmer / mev_bot / compromised / inactive). Costs $0.50 in USDC.
hyperd.wallet.threat_briefComposed wallet threat brief. Fans out to wallet_risk, wallet_anomaly, privacy_mixer_risk, budget_guardian, and wallet_persona then returns a 2-3 sentence security verdict + band (clean / watch / elevated / critical). Replaces a manual 5-call security audit walk. Costs $1.50 in USDC.
hyperd.watch.cancelwrite actionCancel a watch you own. $0.001 USDC ops fee covers the x402 auth path. Returns 404 (not 403) if the watch_id doesn't exist OR if you're not the owner — no existence-leak side-channel.
hyperd.watch.createwrite actionSubscribe to a continuous watch on a wallet/position. Returns watch_id and webhook_secret (shown ONCE — store it; we cannot recover it). HMAC-SHA256 signed alerts POSTed to your webhook_url when threshold conditions are met. v1.0 supports liquidation watches across Aave V3 / Compound v3 / Spark / Morpho. $3.00 USDC prepays for duration_days (default 30, max 90).
hyperd.watch.listList the active watches owned by your wallet. $0.001 USDC ops fee — covers the x402 auth path that proves wallet ownership (without it, the server can't tell which wallet is asking). webhook_secret is NEVER returned — store it from the create response.
hyperd.yield.allocationComposed yield allocation recommender. Fans out 3 parallel /api/yield calls at low/medium/high risk tiers for the same amount + duration, then returns a recommended portfolio split + 2-sentence rationale. Bands: conservative / balanced / aggressive / bespoke. 6h cache bucketed by amount tier × duration × chain. Costs $1.00 in USDC.
hyperd.yield.recommendGet an opinionated DeFi yield recommendation. Filters DefiLlama's pool universe by risk tier (low/medium/high), TVL, and IL exposure, then ranks by APY. Returns the top picks plus projected $ yield over your duration. Costs $0.05 in USDC.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 109 days ago8/15
- Maintainer identityregistry namespace matches repository owner7/10
How Hyperd compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 71/100
- higher than 36% of 48,255 servers
- Tools
- 29
- the typical server has 7
- Tools that change things
- 7%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 54
- more than 45% of 12,191 servers with a package
What its tools let an agent do: 27 read · 2 change
Install Hyperd in Claude Code, Cursor or VS Code
Runs npx -y hyperd-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add hyperd-mcp -- npx -y hyperd-mcp
What the publisher says
From the Hyperd repository's README, as published. We do not edit it. Read it on GitHub
hyperD 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.ai endpoint
- 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/claudedesktopconfig.json, Windows %APPDATA%\Claude\claudedesktopconfig.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 HYPERDWALLETPRIVATE_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 buildThen 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
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Hyperd: common questions
- Is Hyperd MCP server safe?
- Mostly: it is graded B (71/100). Read the Hyperd safety report
- How do I install Hyperd?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Hyperd need an API key?
- Yes. The registry entry asks for
HYPERD_WALLET_PRIVATE_KEY. - Is Hyperd maintained?
- The last commit was 147 days ago (2026-06-09). The latest release is v1.1.1.
- What can I use instead of Hyperd?
- Servers from other publishers that do the same job: World Monitor MCP server.
- How does Hyperd compare with other MCP servers?
- safety score 71/100 (higher than 36% of 48,255 servers); tools 29 (the typical server has 7); tools that change things 7% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Hyperd
Same job from other publishers: the closest match first, then the best rated.
- World MonitorReal-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.not reviewedWidely usedA