TeleKashOracle

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

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

Analytics

Trading

Admin

Pricing

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

Revenue model

Universal Payment Layer

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

// Agent pays per-call — no subscription neededconst 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 marketconst 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.coSUPABASE_ANON_KEY=your-anon-keyTELEKASH_API_KEY=your-api-key              # Optional: enables paid tiersTELEKASH_PAYMENT_ADDRESS=0x...             # Optional: EVM wallet for x402 USDC paymentsTELEKASH_TON_ADDRESS=UQ...                 # Optional: TON wallet for TON paymentsSTRIPE_SECRET_KEY=sk_...                   # Optional: Stripe for fiat paymentsX402_FACILITATOR_URL=https://x402.org/facilitator  # Default: Coinbase facilitator

Data Sources

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

Links

• npm
• GitHub
• Agent Card
• A2A Protocol
• TeleKash Bot

License

MIT