Veynor MCP Server

Prediction market intelligence for AI agents.

Real-time whale trades, market data, alpha signals, and AI-synthesized analysis from Kalshi and Polymarket — available as a Model Context Protocol server and REST API that any AI agent can connect to.

What is this?

The Veynor MCP server gives AI agents (Claude, Cursor, Windsurf, or any MCP-compatible client) direct access to live prediction market data. Instead of scraping websites or parsing unstructured HTML, agents get clean structured data through a standardized protocol — and can reason over it, summarize it, monitor it, and place trades in natural language.

Example prompts your agent can handle once connected:

• "What are whales betting on right now? Any large trades on Iran or tariffs?"
• "What are prediction markets saying about the Fed rate decision?"
• "Find markets where the bid/ask spread is unusually wide."
• "Is the same Fed rate decision priced differently on Kalshi vs Polymarket?"
• "Buy 10 contracts of KXIRANUKE-26 YES at 30 cents."
• "Any unusual volume spikes today? Give me a full signal scan."

Get started in 2 minutes

1. Register for a free API key

curl -X POST https://mcp.veynor.xyz/keys/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'

Response:

{
  "key": "vey_sk_a1b2c3d4...",
  "tier": "free",
  "credits_per_month": 100,
  "connect_url": "https://mcp.veynor.xyz/sse?api_key=vey_sk_a1b2c3d4..."
}

Store your key safely — it won't be shown again.

2. Connect your agent

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "veynor": {
      "url": "https://mcp.veynor.xyz/sse?api_key=vey_sk_YOUR_KEY_HERE"
    }
  }
}

Restart Claude Desktop. You'll see Veynor appear in the tools panel.

Cursor / Windsurf

{
  "mcpServers": {
    "veynor": {
      "url": "https://mcp.veynor.xyz/sse?api_key=vey_sk_YOUR_KEY_HERE"
    }
  }
}

Any MCP-compatible client

SSE endpoint: https://mcp.veynor.xyz/sse?api_key=vey_sk_YOUR_KEY_HERE
Messages:     https://mcp.veynor.xyz/messages

Available tools

query_intelligence

Cost: 5 credits

The most powerful single tool. Ask a natural-language question — the engine automatically detects intent, loads relevant market data, and returns an AI-synthesized analysis written by Claude Haiku. No need to chain multiple tools manually.

Intent routing happens automatically:

• Topic queries ("what are markets saying about Iran?") → relevant markets + synthesis
• Signal queries ("any unusual volume today?") → movers/spikes/spreads + signal summary
• Trade idea queries ("any edge in crypto?") → markets + whale data + trade-angle analysis

Parameters:
  query  Natural-language question or signal request  (required)

Example:

"What are prediction markets pricing on the Iran nuclear deal?"
"Any big movers or unusual volume today?"
"Find edge in crypto prediction markets"
"What's the market saying about Fed rate cuts in 2026?"

get_market_pulse

Cost: 5 credits

Full AI-synthesized market briefing covering top volume, whale activity, price movers, volume spikes, and wide spreads — all in one call. Returns a ready-to-read paragraph written by Claude Haiku plus structured data by category.

Parameters:
  venue     "all" | "kalshi" | "polymarket"
  category  "All" | "Sports" | "Politics" | "Other"

Best for: morning briefings, high-level situation awareness, "what's happening right now" overviews.

get_topic_markets

Cost: 3 credits

Returns active markets for a curated topic tag with an AI-synthesized summary of what the collective market is pricing in. Cross-venue by default.

Parameters:
  tag    "crypto" | "geopolitics" | "trump" | "us_politics" | "macro" | "sports"  (required)
  limit  Max markets (default 20, max 50)

get_alpha_signals

Cost: 3 credits

Returns three types of alpha signals:

• wide_spreads — markets with unusually large bid/ask spreads (liquidity opportunity — not arb)
• price_movers — biggest YES price moves in the last 24h
• arb_opportunities — same event priced differently on Kalshi vs Polymarket simultaneously

Parameters:
  signal_type  "wide_spreads" | "price_movers" | "arb_opportunities" | "all"
  limit        Max results per signal type (1–20, default 10)

get_whale_feed

Cost: 2 credits

Returns the most recent large trades (≥$8,000) across Polymarket and Kalshi. Each trade includes platform, market, side (YES/NO), price, notional size, timestamp, and category.

Parameters:
  limit         Max trades to return (1–60, default 20)
  category      "All" | "Sports" | "Politics" | "Other"
  platform      "all" | "polymarket" | "kalshi"
  min_notional  Minimum trade size in USD (default 8000)

place_kalshi_order

Cost: 2 credits

Places a limit or market order on Kalshi using your registered API credentials. Requires prior credential registration via POST /v1/credentials/kalshi.

Parameters:
  ticker      Kalshi market ticker (e.g. KXIRANUKE-26)  (required)
  action      "buy" | "sell"  (required)
  count       Number of contracts  (required)
  side        "YES" | "NO" (default: YES)
  price       Limit price as probability 0.01–0.99 (required for limit orders)
  order_type  "limit" | "market" (default: limit)

submit_signed_order

Cost: 2 credits

Relays a pre-signed Polymarket EIP-712 order to the CLOB. No-custody: Veynor never holds private keys. Sign locally, relay through Veynor.

Parameters:
  order      EIP-712 order object  (required)
  signature  0x hex signature  (required)
  wallet     Trader's Polymarket proxy wallet address  (required)
  order_type "GTC" | "FOK" | "GTD" (default: GTC)

get_top_markets

Cost: 1 credit

Returns the top 20 most actively traded markets from Kalshi and Polymarket, ranked by 24-hour volume.

Parameters:
  platform  "all" | "kalshi" | "polymarket"
  category  "All" | "Sports" | "Politics" | "Other"
  limit     Max markets per platform (1–20, default 10)

get_market

Cost: 1 credit

Fetch full details for a specific market by ID — prices, volume, open interest, order book summary, and resolution rules.

Parameters:
  platform  "polymarket" | "kalshi"  (required)
  id        Polymarket condition ID (0x...) or Kalshi ticker  (required)

search_markets

Cost: 1 credit

Search for prediction markets by keyword across both platforms. Tokenized search handles multi-word queries well ("fed rate cut", "trump china").

Parameters:
  query     Search query, e.g. "Fed rate", "NBA finals", "Iran"  (required)
  platform  "all" | "polymarket" | "kalshi"
  limit     Max results (1–20, default 10)

get_price_history

Cost: 1 credit

Returns the rolling ~1-hour price history for one specific market (60-second snapshots) with pre-computed 5m, 15m, and 1h price moves.

Parameters:
  platform  "polymarket" | "kalshi"  (required)
  id        Polymarket condition ID or Kalshi ticker  (required)

get_usage

Cost: free

Returns your current credit usage, tier, remaining credits, and per-tool costs. Always free to call.

Credit system

Credits reset on the 1st of each month (UTC).

Tool costs:

Upgrading your plan

# See available plans
curl https://mcp.veynor.xyz/stripe/plans

# Create a Checkout session (returns a payment URL)
curl -X POST https://mcp.veynor.xyz/stripe/checkout \
  -H "Content-Type: application/json" \
  -d '{"api_key": "vey_sk_YOUR_KEY", "price_id": "price_..."}'

After payment, your key is automatically upgraded.

REST API

All data tools are also available as a standard REST API at https://api.veynor.xyz.

Auth: X-API-Key: <key> or Authorization: Bearer <key>

REST example