{"serverInfo":{"name":"hypernatt-terminal","title":"HyperNatt Terminal — BTC Decision Terminal for AI Agents","version":"2.5.11","description":"HyperNatt Terminal — BTC decision context for AI agents from a live Hyperliquid vault (Mimo production stack): MM trap/sweep/reclaim, hunt score, cycle signal, regime similarity, liquidation radar, signed vault proof, and Li.Fi cross-chain swap.\n\nFull HyperNatt platform (vault, assistant, ecosystem): https://hypernatt.com — this MCP is one agent-facing brick. Not a generic market-data wrapper — read-only BTC/USDC context, not trade advice. No custody.\n\nSecurity: no custody, no key access, read-only Decision Core, x402 you control, public code — verify yourself (SECURITY.md).\n\n9 tools · v2.5.11 · Streamable HTTP. Call get_agent_manifest first.\n\nPricing: flat $0.001 per call via x402 (USDC on Base + Solana) — no subscription required. The 5 Decision Core tools (cycle signal, MM hunt, liquidation radar, MM trap state, regime similarity) are $0.001 each; HOLD on get_btc_usdc_signal is not charged. Free: manifest and signed vault proof. Cross-chain swaps route through Li.Fi (you sign your own tx). Heavy use: swap-earned quota or $5/mo Agent Pass (~15,000 credits).\n\nHumans: Claude → Settings → Integrations → Add connector → MCP URL on the domain above (/mcp/protocol), then ask: \"Call get_vault_proof, then get_mm_trap_state — is the MM trapping?\"\n\nDocumentation: github.com/DIALLOUBE-RESEARCH/hypernatt-terminal"},"ecosystem":{"homepage":"https://hypernatt.com","stats_url":"https://hypernatt.com/stats","mcp_url":"https://hypernatt.com/mcp/protocol","pass_status_url":"https://hypernatt.com/api/m2m/pass/status","note":"Discover the full HyperNatt product on the homepage; use this server card for the agent terminal only."},"authentication":{"required":false,"schemes":[]},"privacy_note":"Tool usage (wallet address, tool name, timestamp, market context) is logged to improve HyperNatt Terminal. No prompt content. No resale.","pass_program":{"status_url":"https://hypernatt.com/api/m2m/pass/status","agent_pass_usd":5,"agent_pass_credits":15000,"note":"Pay-per-call $0.001/call via x402 on Base + Solana (no subscription required). Optional Agent Pass $5/mo (~15,000 Decision Core credits, ~67% below paygo) for heavy use. HOLD on get_btc_usdc_signal is not charged. Swap-earned quota also available."},"quota_program":{"status_url":"https://hypernatt.com/api/m2m/quota/status","balance_url":"https://hypernatt.com/api/m2m/quota/balance","note":"Bonus Decision Core credits from NattSwap swap volume (about 20 per $100). Status: GET /api/m2m/quota/status · balance: GET /api/m2m/quota/balance?wallet=0x…"},"tools":[{"name":"get_agent_manifest","description":"Start here: catalog of 9 terminal tools with prices, live usage stats, and proof of edge from our live trading vault. Free.","inputSchema":{"type":"object","properties":{"locale":{"type":"string","description":"en or fr (optional)"}}}},{"name":"get_vault_proof","description":"Free proof we eat our own cooking: on-chain vault address, public URLs, signed cycle hash. Verify our live BTC trades yourself.","inputSchema":{"type":"object","properties":{}}},{"name":"get_mm_trap_state","description":"Is the MM trapping BTC right now? Flagship Decision Core — manipulation weather (trap latch, sweep/reclaim math), not raw cluster data. USE WHEN: sizing risk or you need state (MM_TRAP_ACTIVE), trap_direction (e.g. DOWN_HUNT_LONGS), sweep_zone, chart_verdicts. NOT WHEN: one-line pressure only (get_mm_hunt_score) or raw OI/clusters (get_liq_radar). RETURNS: hypernatt_mm_trap_state_v1 — state, trap_direction, cluster_price, sweep_zone, chart_verdicts, cycles_since_trap. Read-only, not trade advice. COST: $0.001 flat via x402 (Base or Solana). Side effects: none.","inputSchema":{"type":"object","properties":{"x_payment":{"type":"string"},"agent_wallet":{"type":"string","description":"EVM wallet 0x… — quota bypass when balance covers tool weight."}}}},{"name":"get_btc_usdc_signal","description":"Should I align with the live BTC vault? Real-time Mimo cycle LONG/SHORT/HOLD. USE WHEN: vault bias, cycle_id, open PnL (chain_snapshot), checkpoint HOLD. NOT WHEN: MM trap math (get_mm_trap_state) or hunt score alone. RETURNS: hypernatt_mimo_cycle_state_v1 — default summary v2 includes chain_snapshot, checkpoint_snapshot, interpretation_contract_v1 (PnL authority: chain only, not avg_entry). full_payload:true for per-leg detail. HOLD direction is not charged. COST: $0.001 flat via x402 (Base or Solana). Side effects: none.","inputSchema":{"type":"object","properties":{"x_payment":{"type":"string","description":"Base64 x402 payment payload (USDC on Base or Solana). Omit on first call to receive payment instructions."},"agent_wallet":{"type":"string","description":"EVM wallet 0x… — quota bypass when balance covers tool weight."},"full_payload":{"type":"boolean","description":"If true, return full JSON; default compact summary."}}}},{"name":"get_mm_hunt_score","description":"Is the Market Maker hunting your position? One-line liquidation pressure summary. USE WHEN: quick hunt read, alert_level, magnet_bias. NOT WHEN: full trap/sweep math (get_mm_trap_state) or raw clusters (get_liq_radar). RETURNS: hypernatt_mm_hunt_score_v1 — mm_hunt_score (-100..100), pressure_direction, alert_level, long_trap_phase, interpretation_en. COST: $0.001 flat via x402 (Base or Solana). Side effects: none.","inputSchema":{"type":"object","properties":{"x_payment":{"type":"string"},"agent_wallet":{"type":"string","description":"EVM wallet 0x… — quota bypass when balance covers tool weight."},"full_payload":{"type":"boolean"}}}},{"name":"get_similarity_match","description":"What happened last time BTC microstructure looked like this? Top-3 historical regime matches with observed about 4h BTC outcomes (NOT vault PnL). USE WHEN: analogies / regime context only. NOT WHEN: trade direction (get_btc_usdc_signal), live trap (get_mm_trap_state), or sizing. RETURNS: hypernatt_similarity_match_v1 with interpretation_contract_v1, confidence_tier, episode_diversity, matches[]. Agents MUST quote do_not_infer rules — never treat similarity_pct as win probability. COST: $0.001 flat via x402 (Base or Solana). Side effects: none.","inputSchema":{"type":"object","properties":{"x_payment":{"type":"string"},"agent_wallet":{"type":"string","description":"EVM wallet 0x… — quota bypass when balance covers tool weight."},"full_payload":{"type":"boolean"}}}},{"name":"get_liq_radar","description":"Raw BTC liquidation radar — magnet score, OI build-up, long/short ratio, liquidation clusters, 1h/24h liquidations. USE WHEN: you need the full microstructure block (clusters, magnet, OI). NOT WHEN: trap/sweep/reclaim verdicts (get_mm_trap_state) or short hunt narrative (get_mm_hunt_score). RETURNS: hypernatt_liq_radar_v1 with liq_radar { magnet_score, magnet_bias, clusters_above/below, oi_buildup, long_short_ratio }. Redacted, read-only. COST: $0.001 flat via x402 (Base or Solana). Side effects: none.","inputSchema":{"type":"object","properties":{"x_payment":{"type":"string"},"agent_wallet":{"type":"string","description":"EVM wallet 0x… — quota bypass when balance covers tool weight."}}}},{"name":"swap_via_nattswap","description":"Cross-chain token swap powered by Li.Fi across 70+ chains incl. Hyperliquid (any pair — not limited to BTC/USDC). USE WHEN: bridge, fund gas, treasury routing. NOT WHEN: Decision Core BTC reads (get_btc_usdc_signal / trap / hunt) — vault signals stay BTC/USDC only. RETURNS: Li.Fi route JSON + step-by-step agent execution instructions + recommended_action. MCP free; on-chain swap costs gas + integrator fee. Side effects: MCP read-only until wallet signs.","inputSchema":{"type":"object","properties":{"fromChain":{"type":["number","string"]},"toChain":{"type":["number","string"]},"fromToken":{"type":"string"},"toToken":{"type":"string"},"fromAmount":{"type":"string"},"fromAddress":{"type":"string"},"toAddress":{"type":"string"},"slippage":{"type":"number"}},"required":["fromChain","toChain","fromToken","toToken","fromAmount","fromAddress","toAddress"]}},{"name":"swap_quote","description":"Raw Li.Fi swap quote JSON without execution steps. USE WHEN: preview route, fees, and slippage before swap_via_nattswap. NOT WHEN: you need step-by-step agent instructions (use swap_via_nattswap). RETURNS: Li.Fi quote { estimate, toolDetails, transactionRequest, ... }. Free — no x402. Side effects: none.","inputSchema":{"type":"object","properties":{"fromChain":{"type":["number","string"]},"toChain":{"type":["number","string"]},"fromToken":{"type":"string"},"toToken":{"type":"string"},"fromAmount":{"type":"string"},"fromAddress":{"type":"string"},"toAddress":{"type":"string"},"slippage":{"type":"number"}},"required":["fromChain","toChain","fromToken","toToken","fromAmount","fromAddress","toAddress"]}}],"resources":[],"prompts":[]}