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
| Tier | Credits / month | Price |
|---|
| Free | 100 | Free forever |
| Advanced | 2,000 | $29 / month |
| Pro | 10,000 | $89 / month |
| Internal | Unlimited | — |
Credits reset on the 1st of each month (UTC).
Tool costs:
| Tool | Cost |
|---|
query_intelligence | 5 |
get_market_pulse | 5 |
get_topic_markets | 3 |
get_alpha_signals | 3 |
get_whale_feed | 2 |
place_kalshi_order | 2 |
submit_signed_order | 2 |
get_top_markets | 1 |
get_market | 1 |
search_markets | 1 |
get_price_history | 1 |
get_usage | 0 |
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>
| Method | Path | Credits | Notes |
|---|
| GET | /v1/intelligence | 5 | ?q= natural-language query with AI synthesis |
| GET | /v1/pulse | 5 | venue, category — full market briefing |
| GET | /v1/signals | 3 | signal_type, limit |
| GET | /v1/markets/topic/:tag | 3 | tag = crypto|geopolitics|trump|us_politics|macro|sports |
| GET | /v1/whale-trades | 2 | limit, category, platform, min_notional |
| POST | /v1/trade/kalshi | 2 | ticker, action, side, count, price |
| POST | /v1/trade/submit | 2 | Polymarket no-custody relay |
| GET | /v1/markets/top | 1 | platform, category, limit |
| GET | /v1/markets/search | 1 | ?q= required |
| GET | /v1/markets/:platform/:id | 1 | platform = polymarket|kalshi |
| GET | /v1/markets/:platform/:id/history | 1 | Rolling ~1h price history |
| POST | /v1/credentials/kalshi | 0 | Register Kalshi credentials (encrypted at rest) |
| GET | /v1/credentials/kalshi | 0 | Check if credentials are registered |
| DELETE | /v1/credentials/kalshi | 0 | Remove stored credentials |
| GET | /v1/usage | 0 | Credit balance and usage |
REST example
# Natural-language intelligence query
curl -H "X-API-Key: vey_sk_YOUR_KEY" \
"https://api.veynor.xyz/v1/intelligence?q=what+are+markets+saying+about+Iran"
# Whale feed
curl -H "X-API-Key: vey_sk_YOUR_KEY" \
"https://api.veynor.xyz/v1/whale-trades?limit=10&platform=polymarket"
# Place a Kalshi order
curl -X POST https://api.veynor.xyz/v1/trade/kalshi \
-H "X-API-Key: vey_sk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"ticker":"KXIRANUKE-26","action":"buy","side":"YES","count":10,"price":0.30}'
Example agent workflows
One-shot intelligence query
"What are prediction markets saying about a US recession in 2026?"
Uses query_intelligence — one call, full synthesis.
Morning briefing
"Give me the full market pulse — top volume, whale activity, biggest movers."
Uses get_market_pulse.
Arb scanner
"Run alpha signals for arb_opportunities. For any gap > 5 cents, show details."
Uses get_alpha_signals.
Trade execution
"Find Kalshi markets on the Fed rate decision, then buy 5 contracts YES at 40 cents."
Uses search_markets → place_kalshi_order.
Liquidity hunting
"Show markets with wide bid/ask spreads where providing liquidity would be profitable."
Uses get_alpha_signals with signal_type=wide_spreads.
Geopolitics scan
"What are all the Iran and Taiwan markets pricing right now? Any divergence between platforms?"
Uses get_topic_markets with tag=geopolitics.
Data sources
- Polymarket — Gamma API and CLOB API (real-time)
- Kalshi — Trade API v2 (real-time)
- Whale feed — proprietary monitoring of large trades across both platforms
- Alpha signals — rolling scanner updated every ~60 seconds
Roadmap
Self-hosting
git clone https://github.com/veynor-xyz/veynor-mcp
cd mcp-server
npm install
cp .env.example .env
npm run build
npm start
Required env vars:
MCP_PORT=3001
MCP_ADMIN_SECRET=your-secret-here
VEYNOR_API_URL=http://localhost:3000 # URL of your Next.js app
ANTHROPIC_API_KEY=sk-ant-... # Required for AI synthesis tools
The server runs on port 3001 by default. The Next.js app must be running at VEYNOR_API_URL — the MCP server reads data files from disk and calls the intelligence endpoint via localhost HTTP.
Community
Built by the Veynor team. Prediction markets meet AI agents.
