Skip to main content
Glama
telekash-mcp-server

telekash-mcp-server

TeleKash MCP Server

Prediction market probability oracle for AI agents.

npm version License: MIT MCP Compatible Node 18+

What is this?

TeleKash is the probability oracle for the agent economy. Real-time access to 4,500+ live prediction markets from Kalshi (CFTC-regulated) and Polymarket. Structured trading signals, cross-source arbitrage detection, noise filtering, and smart trade routing across crypto, politics, sports, entertainment, finance, weather, tech, and science.

What makes it different:

  • Multi-source — Kalshi + Polymarket + native pools, not single-exchange

  • Self-calibrating — Platt scaling with daily recalibration cycles and Brier score tracking

  • Universal Payment Layer — agents pay per-call with USDC (Base/Polygon/Solana via x402), fiat (Stripe), or TON

  • 28 tools — from free probabilities to broker execution with 1% commission

Related MCP server: Rekko MCP

Quick Install

npx telekash-mcp-server

Claude Code

claude mcp add telekash-oracle npx telekash-mcp-server

Claude Desktop / Cursor

Add to your MCP configuration file:

{
  "mcpServers": {
    "telekash-oracle": {
      "command": "npx",
      "args": ["telekash-mcp-server"]
    }
  }
}

Tools

28 tools across 4 categories. All tools work without an API key on the Free tier (100 queries/day). 4,500+ live markets.

Intelligence

Tool

What it does

Tier

get_probability

Real-time YES/NO probability with volume-weighted confidence score

Free

list_markets

Browse markets by category, source, jurisdiction, with sorting

Free

search_markets

Full-text search across 4,500+ markets

Free

get_history

Historical probability changes over 1h, 24h, 7d, 30d

Free

get_sentiment

AI sentiment analysis with conviction, momentum, and noise filter

Free

get_market_stats

Aggregate statistics across all markets and sources

Free

get_trending

Markets with the biggest probability swings

Free

compare_sources

Kalshi vs Polymarket side-by-side odds comparison

Calibration

Analytics

Tool

What it does

Tier

detect_arbitrage

Cross-source arbitrage opportunities with buy/sell signals

Calibration

get_signal

Structured TPF signal: probability + sentiment + noise filter + verdict

Calibration

get_divergences

Markets where sources disagree most (STRONG/MODERATE/WEAK)

Calibration

get_edge

Kelly Criterion sizing, expected value, and risk classification

Calibration

track_prediction

Record predictions for accuracy tracking

Calibration

get_performance

Brier score, calibration curve, edge-vs-market analysis

Calibration

Trading

Tool

What it does

Tier

execute_trade

Route trades to Kalshi, Polymarket, or native parimutuel pools

Edge

get_order_status

Check fill status, price, and commission on broker orders

Edge

cancel_order

Cancel pending or submitted broker orders

Edge

get_pool_status

Native pool composition, participant counts, implied odds

Edge

get_agent_balance

Agent balance, P&L, win rate, and pool position count

Edge

get_resolution_status

Multi-source resolution verification and confidence levels

Edge

create_market

Create custom binary prediction markets

Edge

export_data

Bulk export: probability history, resolutions, catalogs, arbitrage

Edge

Admin

Tool

What it does

Tier

generate_api_key

Generate a free API key (no signup required)

Free

get_usage

Check current API usage, rate limits, and tier status

Free

register_alert

Webhook alerts for probability crosses, mispricings, volume spikes

Edge

list_alerts

List active webhook alerts with delivery stats

Edge

delete_alert

Delete a webhook alert

Edge

get_health

System health: connectivity, data freshness, broker status

Free

Pricing

Per-query pricing. No subscriptions. Free tier requires no API key.

Tier

Cost

Queries/Day

What you get

Free

$0

100

Probabilities, search, trending, sentiment, stats, health

Calibration

$0.01/query

1,000

+ Cross-source comparison, arbitrage, signals, divergence, Kelly sizing, performance tracking

Edge

$0.05/query

Unlimited

+ Broker trading (1% commission), native pools (5% fee), webhooks, data export, market creation

Revenue model

Stream

Rate

Description

Intelligence queries

$0 - $0.05/query

Real-time probability, sentiment, signals

Broker trades

1% commission

Best-price execution routed to Kalshi or Polymarket

Native pool trades

5% fee at resolution

Parimutuel pools alongside Telegram users

Universal Payment Layer

Agents can also pay per-call without an API key or tier — attach payment proof directly in tool arguments.

Rail

Network

Asset

Fee

x402 (Coinbase)

Base, Polygon, Solana

USDC

Free (0%)

Stripe MPP

Fiat

USD (cards, bank)

2.9%

TON

TON mainnet

TON

Free (0%)

// Agent pays per-call — no subscription needed
const result = await client.callTool({
  name: "get_signal",
  arguments: {
    query: "Bitcoin 200K",
    x402_payment: {
      tx_hash: "0xabc...",
      network: "base",
      rail: "x402",
    },
  },
});

Get an API key

# Via the MCP server itself (free tier, no signup)
# Call the generate_api_key tool

# Or via Telegram
# Message @TeleKashBot with /apikey

Example

Connect to the server and query a market probability:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["telekash-mcp-server"],
});

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);

// Get probability for a market
const result = await client.callTool({
  name: "get_probability",
  arguments: { query: "Will Bitcoin hit $200K by end of 2026?" },
});

console.log(result.content);
// => { probability: { yes: 34, no: 66 }, confidence: { grade: "HIGH", score: 82 }, ... }

More examples in the examples/ directory:

  • quick-start.ts -- Connect, search, get probabilities

  • arbitrage-scanner.ts -- Find cross-source mispricings

  • portfolio-scanner.ts -- Scan markets and build a ranked portfolio

  • market-monitor.ts -- Watch a market and log probability changes

Environment Variables

The server works without any credentials (returns demo data). For live market access:

SUPABASE_URL=https://rrkjtdnxkscukexbsrue.supabase.co
SUPABASE_ANON_KEY=your-anon-key
TELEKASH_API_KEY=your-api-key              # Optional: enables paid tiers
TELEKASH_PAYMENT_ADDRESS=0x...             # Optional: EVM wallet for x402 USDC payments
TELEKASH_TON_ADDRESS=UQ...                 # Optional: TON wallet for TON payments
STRIPE_SECRET_KEY=sk_...                   # Optional: Stripe for fiat payments
X402_FACILITATOR_URL=https://x402.org/facilitator  # Default: Coinbase facilitator

Data Sources

Source

Type

Sync Frequency

Kalshi

CFTC-regulated US exchange

Every 15 minutes

Polymarket

Crypto-native exchange

Every hour

All sources are aggregated, deduplicated, and categorized automatically across 8 categories: crypto, politics, sports, entertainment, finance, weather, tech, science.

License

MIT

Available Tools

9 tools
generate_api_keyA

Generate a free TeleKash API key for rate-limited access to prediction market intelligence.

Free tier: 100 calls/day, 7 core tools (probability, markets, search, history, sentiment, stats, trending). Calibration tier ($99/mo): 1,000 calls/day + arbitrage, divergence, and performance tracking tools. Edge tier ($499/mo): Unlimited + TPF signals, Kelly sizing, and market creation.

The API key is returned ONCE — save it immediately. Set it as TELEKASH_API_KEY environment variable.

Inputs: owner_id (required), owner_email.

get_historyA

Get historical probability changes and trend data for a prediction market over time.

Returns probability snapshots showing how odds, sentiment, and market consensus have shifted over 1h, 24h, 7d, or 30d. Use for trend analysis, momentum detection, volatility assessment, and understanding how predictions evolve. Essential for backtesting strategies, identifying probability swings, and spotting market-moving events.

Inputs: market_id (required), timeframe.

get_market_statsA

Get aggregate statistics across all prediction markets — totals, categories, sources, and volume.

Returns total market count, active markets, category distribution, source breakdown (Kalshi vs Polymarket), and aggregate trading volume. Use for market overview, portfolio allocation decisions, or understanding the prediction market landscape.

Inputs: no named parameters.

get_probabilityA

Get real-time probability, odds, and likelihood for any prediction market outcome.

Returns YES/NO probabilities (0-100%), trading volume, liquidity depth, and market metadata from Kalshi (CFTC-regulated) and Polymarket. Use this when asked about chances, odds, likelihood, forecasts, or predictions for any event — elections, crypto prices, sports, economics, weather, entertainment.

Example queries:

  • "What are the odds Trump wins 2028?" → election forecasting

  • "What's the probability BTC hits $200K?" → crypto price prediction

  • "Will the Fed cut rates?" → economic forecasting, interest rates

  • "What's the chance of rain in NYC?" → weather betting

  • "Who will win the Super Bowl?" → sports odds

Inputs: market_id, query.

get_sentimentA

Get AI-powered sentiment analysis, recommendation, and confidence score for any prediction market.

Returns sentiment score (-1 to 1), actionable recommendation (bullish/bearish/neutral), and AI confidence level. Goes beyond raw probability — analyzes market psychology, crowd wisdom, and directional bias. Use for trade signals, contrarian analysis, or augmenting your own prediction models with market sentiment data.

Inputs: market_id (required).

get_usageB

Check your current API usage, rate limits, and tier status.

Returns calls made today, calls remaining, tier, and upgrade options.

Inputs: no named parameters.

list_marketsA

Browse and discover prediction markets across 7 categories with filtering and sorting.

Lists active betting markets from Kalshi, Polymarket, and Metaculus. Filter by category, sort by trading volume, probability, or closing date. 500+ markets available. Categories: sports, crypto, politics, economics, pop_culture, weather, other. Use when exploring what predictions are available, finding trending markets, or discovering betting opportunities.

Example queries:

  • "Show me crypto prediction markets" → Bitcoin, Ethereum, altcoin forecasts

  • "What sports markets are trending?" → NFL, NBA, soccer odds

  • "List political predictions" → elections, legislation, geopolitics

  • "What economic forecasts are available?" → GDP, inflation, interest rates

Inputs: category, sort_by, limit, source, +1 more.

search_marketsA

Search 500+ prediction markets by keyword, topic, or natural language query.

Full-text search across Kalshi, Polymarket, and Metaculus. Finds markets matching any topic — politics, crypto, sports, economics, entertainment, science, technology, weather. Returns matching active markets sorted by relevance and trading volume. Use when looking for specific predictions, events, or outcomes to bet on.

Example queries:

  • "Trump election 2028" → presidential race odds

  • "Bitcoin price prediction" → BTC price target markets

  • "Super Bowl winner" → NFL championship odds

  • "AI regulation" → technology policy predictions

  • "Fed interest rate" → monetary policy forecasts

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: generate_api_key handles authentication, get_history provides historical trends, get_market_stats gives aggregate data, get_probability offers real-time odds, get_sentiment analyzes market psychology, get_trending identifies momentum, get_usage checks API limits, list_markets browses categories, and search_markets performs keyword searches. The descriptions clearly differentiate their functions, making misselection unlikely.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, such as generate_api_key, get_history, list_markets, and search_markets. This uniformity makes the toolset predictable and easy to navigate, with no deviations in naming conventions.

    Tool Count5/5

    With 9 tools, the count is well-scoped for a prediction market intelligence server, covering core functionalities like data retrieval, analysis, and management without being overwhelming. Each tool serves a specific, necessary role in the domain, making the set appropriately sized.

    Completeness4/5

    The toolset provides comprehensive coverage for accessing and analyzing prediction market data, including real-time probabilities, historical trends, sentiment, and market discovery. A minor gap exists in lacking tools for direct market interaction (e.g., placing bets or managing positions), but the described tools support core intelligence workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      24/7 autonomous monitoring and edge detection for prediction markets (Kalshi & Polymarket). Features causal tree analysis, orderbook depth tracking, cross-venue comparison, and real-time alerts.
      16
      196 npm
      12
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides prediction market intelligence, research, and strategy signals for platforms like Kalshi, Polymarket, and Robinhood. It enables AI assistants to perform market screening, arbitrage detection, and deep causal analysis to support informed trading decisions.
      27
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Prediction market intelligence for AI agents, enabling real-time access to whale trades, market data, signals, and AI-synthesized analysis from Kalshi and Polymarket via a standardized protocol.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables MCP-compatible AI agents to research and trade prediction markets on Polymarket and Kalshi, including market search, orderbooks, price history, positions, order routing, and on-chain builder-code attribution, plus overshoot and dispute-risk signals.
      42
      112 PyPI
      1
      MIT