# hyperD x402 | DeFi APIs for AI Agents (verified)

**23 tools. USDC settlement on Base mainnet. ~2 seconds end-to-end. No API keys.**

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add hyperd/hyperd-mcp

# Browse available tools
npx -y smithery tool list hyperd/hyperd-mcp

# Get full schema for a tool
npx -y smithery tool get hyperd/hyperd-mcp hyperd.catalog.list

# Call a tool
npx -y smithery tool call hyperd/hyperd-mcp hyperd.catalog.list '{}'
```

## Tools (23)

- `hyperd.catalog.list` — List all available hyperD x402 API endpoints with their prices, descriptions, and example responses. FREE — no wallet r…
- `hyperd.pricing.get` — Get the current price list for all hyperD paid endpoints (in USDC on Base). FREE — no wallet required.
- `hyperd.health.check` — Check the health of the hyperD API: which network it's on, whether the payment facilitator is configured, which optiona…
- `hyperd.balance.get` — Get the on-chain balance for an EVM wallet address. Multi-chain (Base, Ethereum, Polygon, Arbitrum). Supports ERC-20 by…
- `hyperd.yield.recommend` — Get an opinionated DeFi yield recommendation. Filters DefiLlama's pool universe by risk tier (low/medium/high), TVL, an…
- `hyperd.token.info` — Get aggregated token metadata: market cap, supply, contract addresses across chains, recent volume. One call replaces m…
- `hyperd.token.security` — Get a token's security risk score (0-100). Ensemble of GoPlus signals: honeypot detection, owner permissions, holder co…
- `hyperd.wallet.risk` — Check a wallet's risk profile. Combines Chainalysis Sanctions Oracle (OFAC SDN authoritative) with GoPlus address heuri…
- `hyperd.protocol.tvl` — Get a DeFi protocol's TVL, audits, chain distribution from DefiLlama. Pass slug for detail (e.g., 'aave', 'morpho-blue'…
- `hyperd.gas.estimate` — Get current gas price + base fee + tip percentiles for fast/standard/slow inclusion. Costs $0.005 in USDC.
- `hyperd.dex.quote` — Get the best DEX swap route across multiple aggregators (Paraswap + 0x). Returns the highest output amount and per-sour…
- `hyperd.wallet.persona` — Classify a wallet's persona based on on-chain behavior. Returns one of: Trader, HODLer, MEV-bot, Whale, Smart-Money, Ai…
- `hyperd.contract.audit` — Pre-trade contract security audit. Composes GoPlus + Sourcify + DefiLlama protocol recognition + on-chain heuristics in…
- `hyperd.governance.summarize` — Summarize a DAO governance proposal (Snapshot or Tally URL). Returns structured impact analysis: who benefits, who pays…
- `hyperd.sentiment.token` — Get a token's sentiment score (0-100) from recent Farcaster discussion. Returns score, band (very_negative to very_posi…
- `hyperd.liquidation.risk` — Cross-protocol liquidation risk for a wallet's lending positions. Health factor, USD-at-risk, and recommendations acros…
- `hyperd.wallet.anomaly` — Wallet behavioral anomaly detection. Compares recent activity against the wallet's own 180-day baseline — surfaces tx-v…
- `hyperd.wallet.pnl` — Realized + unrealized P&L for a wallet over a time window. ERC-20 + native, single chain per call. Three cost-basis met…
- `hyperd.budget.guardian` — Agent spend visibility: aggregates recent outbound USDC transfers from a wallet over a configurable window (1h/24h/7d/3…
- `hyperd.bundle` — Bundle multiple paid GET calls into one x402 settlement. Up to 10 sub-calls executed in parallel (concurrency cap 4), p…
- `hyperd.watch.create` — Subscribe to a continuous watch on a wallet/position. Returns watch_id and webhook_secret (shown ONCE — store it; we ca…
- `hyperd.watch.list` — List the active watches owned by your wallet. $0.001 USDC ops fee — covers the x402 auth path that proves wallet owners…
- `hyperd.watch.cancel` — Cancel a watch you own. $0.001 USDC ops fee covers the x402 auth path. Returns 404 (not 403) if the watch_id doesn't ex…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get hyperd/hyperd-mcp <tool-name>
```
