HyperNatt Terminal: BTC Decision Context for Hermes Agent via MCP

What It Does

HyperNatt Terminal connects a Hermes Agent to live, read-only BTC/USDC decision context sourced from a production Hyperliquid vault (the Mimo stack). Once wired up, the agent can call nine tools that provide market-making trap/sweep/reclaim state, hunt scores, cycle signals, regime similarity data, liquidation radar, signed vault proofs, and cross-chain swap quotes routed through Li.Fi. The terminal is an MCP (Model Context Protocol) server, so any MCP-capable client, including Hermes Agent, can use it.

Concrete capabilities from the sources:

• Read-only BTC/USDC decision context from a live Hyperliquid vault.
• Nine tools total, including vault proofs and cross-chain swap functionality via Li.Fi.
• Signed vault proofs that can be verified on-chain.
• MM trap/sweep/reclaim state detection.
• Hunt score, cycle signal, and regime similarity measurements.
• Liquidation radar data.
• Cross-chain swap quoting and execution (user signs own transaction; 0.5% fee).
• Streamable HTTP transport (v2.5.11).
• Pricing via x402 micropayments at $0.001 per call (USDC on Base and Solana).

According to the official documentation, HyperNatt Terminal is "not a generic market-data wrapper" and provides "read-only BTC/USDC context, not trade advice." It explicitly states "no custody, no key access, read-only Decision Core, x402 you control, public code."

Setup

Prerequisites

• A Hermes Agent instance (or any MCP-compatible client).
• For paid tools: a wallet capable of sending USDC on Base or Solana for x402 micropayments.
• No wallet is needed for the free tools (manifest, signed vault proof, swap quotes).

Quick Test Without Installation

Both sources provide a way to test the terminal with zero setup. Run these curl commands from any terminal:

curl -s https://hypernatt.com/api/m2m/agent/manifest      # full catalog, free
curl -s https://hypernatt.com/api/m2m/proof-of-edge       # live vault data; edge measurement preliminary, verify on-chain

The first call returns the full catalog of nine tools, their prices, and ecosystem links. The second returns live vault data. Both are free and require no authentication.

Connecting from Hermes Agent

To connect a Hermes Agent to HyperNatt Terminal, you need to configure the agent to use the MCP protocol endpoint. The sources do not provide a Hermes-specific configuration file, but they describe the general MCP connection pattern:

1. Point your MCP client to the MCP URL on the domain https://hypernatt.com/mcp/protocol.
2. Call get_agent_manifest first. The sources state: "Call get_agent_manifest first."
3. After the manifest is returned, the agent can call any of the nine tools.

For a human using Claude as a test, the sources show this path: "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?'" The same MCP URL works for Hermes Agent.

Running a Local Python Example

Both sources include a runnable Python example that uses only the standard library and requires no wallet:

python examples/btc_trap_aware_min.py

This script is part of the repository at examples/btc_trap_aware_min.py. It demonstrates how to call the terminal's tools programmatically.

Authentication and Payments

Paid tools use the x402 protocol for micropayments. According to the sources, "Pricing: flat $0.001 per call via x402 (USDC on Base + Solana) - no subscription required." The five Decision Core tools cost $0.001 each. The first call per tool is free (intro). The HOLD on get_btc_usdc_signal is not charged. There is no daily credit pool.

Free tools include: manifest, signed vault proof, and swap quotes. Cross-chain swaps route through Li.Fi, and the user signs their own transaction. Li.Fi charges a 0.5% fee.

For heavy use, the sources mention two alternatives: "swap-earned quota or the $5/mo Agent Pass (~15,000 Decision Core credits, ~67% below paygo)."