# Veynor — Prediction Market Intelligence [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/veynor-xyz/veynor-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/veynor-prediction-market-intelligence

## Description
Prediction market intelligence for AI agents. Live data from Kalshi and Polymarket.

## Tools
Capabilities this server exposes over MCP:

- **query_intelligence** — **Cost: 5 credits**
- **get_market_pulse** — **Cost: 5 credits**
- **get_topic_markets** — **Cost: 3 credits**
- **get_alpha_signals** — **Cost: 3 credits**
- **get_whale_feed** — **Cost: 2 credits**
- **place_kalshi_order** — **Cost: 2 credits**
- **submit_signed_order** — **Cost: 2 credits**
- **get_top_markets** — **Cost: 1 credit**
- **get_market** — **Cost: 1 credit**
- **search_markets** — **Cost: 1 credit**
- **get_price_history** — **Cost: 1 credit**
- **get_usage** — **Cost: free**

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "veynor-prediction-market-intelligence": {
    "command": "npx",
    "args": ["-y","veynor-prediction-market-intelligence"]
  }
}
```

## Documentation & README

# 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](https://modelcontextprotocol.io) 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

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

Response:
```json
{
  "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`:

```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

```json
{
  "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

```bash
# 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

```bash
# 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

- [x] Whale feed monitoring (Polymarket + Kalshi)
- [x] Top markets by volume
- [x] Alpha signals (wide spreads, price movers, arb)
- [x] Market search with tokenized multi-word matching
- [x] MCP server with SSE transport
- [x] Self-serve key registration
- [x] REST API v1
- [x] Price history (rolling 1h, 60s snapshots)
- [x] Market pulse — AI briefing synthesis
- [x] Topic markets with AI analysis (crypto, geopolitics, macro, sports, trump, us_politics)
- [x] Place Kalshi orders via MCP / REST
- [x] Polymarket no-custody order relay
- [x] Kalshi credential storage (AES-256-GCM encrypted at rest)
- [x] Natural-language intelligence queries (`query_intelligence`)
- [x] Stripe integration for plan upgrades
- [ ] Streaming whale alerts (webhook / websocket)
- [ ] Portfolio monitoring tool
- [x] MCP registry listing

---

## Self-hosting

```bash
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:

```env
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

- **X / Twitter:** [@veynor_xyz](https://x.com/veynor_xyz)
- **Discord:** [discord.gg/qYaRfhmq](https://discord.gg/qYaRfhmq)
- **Telegram:** [t.me/predmarketwhales](https://t.me/predmarketwhales)
- **Email:** hello@veynor.xyz

Built by the Veynor team. Prediction markets meet AI agents.