Horizon Pulse MCP server

Horizon Pulse

Pay-per-call crypto market pulse, signals, funding, yield rankings, portfolio risk, gas, plus public URL fetch → clean text, universal http proxy, and extract → structured fields for AI agents, monetized with the x402 protocol on Base mainnet and Solana mainnet (USDC, exact, same price on both).

This repo is a Next.js App Router service ready to deploy (e.g. Vercel) and push to:

https://github.com/horizon-pulse/horizon-pulse.git

Public host

Prefer horizonpulse.dev in agent docs, OpenAPI, and clients. The *.vercel.app URL remains a working fallback.

What it is

• Agents hit live paid HTTP endpoints (crypto routes frozen; /api/fetch + /api/http + /api/extract + /api/x402-check + /api/bazaar-check + /api/market/search + /api/market/quote + /api/screenshot + /api/search + /api/pdf non-crypto LIVE — see below).
• Unpaid requests receive HTTP 402 with x402 v2 requirements: canonical wire is the PAYMENT-REQUIRED header, with one accepts entry per network: Base (CAIP-2 eip155:8453, Base USDC, the treasury below) and Solana (CAIP-2 solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, USDC mint, the Solana payTo below). See docs/solana-rail.md.
• Retry with an x402 v2 PAYMENT-SIGNATURE header. The facilitator (Coinbase CDP on Base, PayAI on Solana) verifies + settles, then the route returns live data.
• No stubbed prices or fake APYs: Coinbase Exchange (CoinGecko fallback) for spot; CoinGecko OHLC (Coinbase candles fallback) for signals; OKX for perpetual funding (Binance/Bybit are often geo-blocked on Vercel); DefiLlama for yield pools; public RPC balanceOf for portfolio (real balances only); ethfeeHistory / ethgasPrice for gas (real fees only); /api/fetch returns best-effort cleaned text from a requested public URL (SSRF-safe, size/time capped); /api/http is a raw universal proxy (filtered headers, text|base64 body, SSRF-safe) priced $0.01 for volume; /api/extract returns best-effort structured page fields from a URL or HTML (SSRF-safe, size/time capped) priced $0.015.
• Never invent metrics; never advertise routes that 404; never cite a cached balance — /status reads live USDC balanceOf on payTo. Honest: current payTo is interim Coinbase-custodial (not Safe/multisig).

Catalog status (post first settlement)

Coming-soon / placeholder / 404 routes are not listed on /, /status, or this README.

Agent how-to (x402 v2)

1. GET a paid route with no payment → HTTP 402.
2. Read PAYMENT-REQUIRED (v2) and pick one accepts entry. Confirm network (eip155:8453 for Base or solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp for Solana), USDC on that network, exact atomic amount, and that network's payTo.
3. Sign and retry the same GET with PAYMENT-SIGNATURE (v2 primary; do not rely on legacy X-PAYMENT as the settle path).
4. On success: the facilitator settles on the network you paid on; response body is the live JSON for that route.

Optional: OPTIONS on a paid route returns discovery + the same PAYMENT-REQUIRED challenge without charging.

Shortened. The full README is on GitHub.