TeleKash MCP Server
Prediction market probability oracle for AI agents.
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 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 probabilitiesarbitrage-scanner.ts-- Find cross-source mispricingsportfolio-scanner.ts-- Scan markets and build a ranked portfoliomarket-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
All sources are aggregated, deduplicated, and categorized automatically across 8 categories: crypto, politics, sports, entertainment, finance, weather, tech, science.
Links
License
MIT