Predmcp

What is PredMCP?

PredMCP is a read-only MCP server that provides 44 tools for querying market data from Polymarket prediction markets, Hyperliquid perpetuals, and HIP-4 native predictions. It is designed for AI trading agents to access live trading data without the ability to execute orders.

How to use PredMCP?

Use the hosted server by obtaining a free API key at predmcp.com/signup (100 calls/day, no credit card) and configure your MCP client (e.g., Claude Desktop, Cursor, Windsurf) with the HTTP transport URL and API key. Alternatively, self-host the open-source core by cloning the repository, running npm install && npm run build, and starting with IP_HASH_PEPPER="$(openssl rand -hex 32)" npm start.

Key features of PredMCP

• 44 read-only MCP tools across three prediction venues.
• No execution endpoint – zero order-placement code.
• No private keys required – uses public APIs only.
• Tools include market data, orderbooks, funding rates, signals.
• Cross-venue intelligence signals (e.g., divergence detection).
• Free during early access, hosted version available.

Use cases of PredMCP

• AI agent queries prediction market odds for geopolitical events.
• Agent monitors funding rate divergences between Hyperliquid and Polymarket.
• Agent identifies whale activity across both venues.
• Agent analyzes market volume spikes and movers in 24 hours.
• Agent compares BTC perp pricing with HIP-4 prediction markets.

FAQ from PredMCP

Does PredMCP allow trading?

No. The codebase contains zero order-placement code – not gated, not commented out, not implemented. Every tool is a read-only query.

What data sources does PredMCP use?

It uses the public Hyperliquid Info API, Polymarket Gamma API, and HIP-4 native predictions. No private keys or wallet data are ever accessed.

How do I get started with the hosted server?

Sign up for a free API key at predmcp.com/signup (email only, no credit card, 100 calls/day). Then add the HTTP transport configuration to your MCP client with the provided URL and API key.

Can I self-host PredMCP?

Yes, the open-source core is available on GitHub. It covers the read-only data layer (Polymarket + Hyperliquid wrappers, MCP server, signup/auth). The intelligence/private tools (signals, conviction scores, macro flow) are only available in the hosted version.

What are the runtime requirements?

The server is built with TypeScript, Fastify, MCP SDK, SQLite (better-sqlite3), and interfaces with Polymarket Gamma API and Hyperliquid Info API. It runs on Node.js.