{
  "markdown": "# TeleKash MCP Server\n\n**Prediction market probability oracle for AI agents.**\n\n[![npm version](https://img.shields.io/npm/v/telekash-mcp-server.svg)](https://www.npmjs.com/package/telekash-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io)\n[![Node 18+](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)\n\n## What is this?\n\nTeleKash 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.\n\n**What makes it different:**\n\n- **Multi-source** — Kalshi + Polymarket + native pools, not single-exchange\n- **Self-calibrating** — Platt scaling with daily recalibration cycles and Brier score tracking\n- **Universal Payment Layer** — agents pay per-call with USDC (Base/Polygon/Solana via x402), fiat (Stripe), or TON\n- **28 tools** — from free probabilities to broker execution with 1% commission\n\n## Quick Install\n\n```bash\nnpx telekash-mcp-server\n```\n\n### Claude Code\n\n```bash\nclaude mcp add telekash-oracle npx telekash-mcp-server\n```\n\n### Claude Desktop / Cursor\n\nAdd to your MCP configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"telekash-oracle\": {\n      \"command\": \"npx\",\n      \"args\": [\"telekash-mcp-server\"]\n    }\n  }\n}\n```\n\n## Tools\n\n28 tools across 4 categories. All tools work without an API key on the Free tier (100 queries/day). 4,500+ live markets.\n\n### Intelligence\n\n| Tool               | What it does                                                       | Tier        |\n| ------------------ | ------------------------------------------------------------------ | ----------- |\n| `get_probability`  | Real-time YES/NO probability with volume-weighted confidence score | Free        |\n| `list_markets`     | Browse markets by category, source, jurisdiction, with sorting     | Free        |\n| `search_markets`   | Full-text search across 4,500+ markets                             | Free        |\n| `get_history`      | Historical probability changes over 1h, 24h, 7d, 30d               | Free        |\n| `get_sentiment`    | AI sentiment analysis with conviction, momentum, and noise filter  | Free        |\n| `get_market_stats` | Aggregate statistics across all markets and sources                | Free        |\n| `get_trending`     | Markets with the biggest probability swings                        | Free        |\n| `compare_sources`  | Kalshi vs Polymarket side-by-side odds comparison                  | Calibration |\n\n### Analytics\n\n| Tool               | What it does                                                            | Tier        |\n| ------------------ | ----------------------------------------------------------------------- | ----------- |\n| `detect_arbitrage` | Cross-source arbitrage opportunities with buy/sell signals              | Calibration |\n| `get_signal`       | Structured TPF signal: probability + sentiment + noise filter + verdict | Calibration |\n| `get_divergences`  | Markets where sources disagree most (STRONG/MODERATE/WEAK)              | Calibration |\n| `get_edge`         | Kelly Criterion sizing, expected value, and risk classification         | Calibration |\n| `track_prediction` | Record predictions for accuracy tracking                                | Calibration |\n| `get_performance`  | Brier score, calibration curve, edge-vs-market analysis                 | Calibration |\n\n### Trading\n\n| Tool                    | What it does                                                       | Tier |\n| ----------------------- | ------------------------------------------------------------------ | ---- |\n| `execute_trade`         | Route trades to Kalshi, Polymarket, or native parimutuel pools     | Edge |\n| `get_order_status`      | Check fill status, price, and commission on broker orders          | Edge |\n| `cancel_order`          | Cancel pending or submitted broker orders                          | Edge |\n| `get_pool_status`       | Native pool composition, participant counts, implied odds          | Edge |\n| `get_agent_balance`     | Agent balance, P&L, win rate, and pool position count              | Edge |\n| `get_resolution_status` | Multi-source resolution verification and confidence levels         | Edge |\n| `create_market`         | Create custom binary prediction markets                            | Edge |\n| `export_data`           | Bulk export: probability history, resolutions, catalogs, arbitrage | Edge |\n\n### Admin\n\n| Tool               | What it does                                                       | Tier |\n| ------------------ | ------------------------------------------------------------------ | ---- |\n| `generate_api_key` | Generate a free API key (no signup required)                       | Free |\n| `get_usage`        | Check current API usage, rate limits, and tier status              | Free |\n| `register_alert`   | Webhook alerts for probability crosses, mispricings, volume spikes | Edge |\n| `list_alerts`      | List active webhook alerts with delivery stats                     | Edge |\n| `delete_alert`     | Delete a webhook alert                                             | Edge |\n| `get_health`       | System health: connectivity, data freshness, broker status         | Free |\n\n## Pricing\n\nPer-query pricing. No subscriptions. Free tier requires no API key.\n\n| Tier            | Cost        | Queries/Day | What you get                                                                                    |\n| --------------- | ----------- | ----------- | ----------------------------------------------------------------------------------------------- |\n| **Free**        | $0          | 100         | Probabilities, search, trending, sentiment, stats, health                                       |\n| **Calibration** | $0.01/query | 1,000       | + Cross-source comparison, arbitrage, signals, divergence, Kelly sizing, performance tracking   |\n| **Edge**        | $0.05/query | Unlimited   | + Broker trading (1% commission), native pools (5% fee), webhooks, data export, market creation |\n\n### Revenue model\n\n| Stream               | Rate                 | Description                                         |\n| -------------------- | -------------------- | --------------------------------------------------- |\n| Intelligence queries | $0 - $0.05/query     | Real-time probability, sentiment, signals           |\n| Broker trades        | 1% commission        | Best-price execution routed to Kalshi or Polymarket |\n| Native pool trades   | 5% fee at resolution | Parimutuel pools alongside Telegram users           |\n\n### Universal Payment Layer\n\nAgents can also pay per-call without an API key or tier — attach payment proof directly in tool arguments.\n\n| Rail                | Network               | Asset             | Fee       |\n| ------------------- | --------------------- | ----------------- | --------- |\n| **x402** (Coinbase) | Base, Polygon, Solana | USDC              | Free (0%) |\n| **Stripe MPP**      | Fiat                  | USD (cards, bank) | 2.9%      |\n| **TON**             | TON mainnet           | TON               | Free (0%) |\n\n```typescript\n// Agent pays per-call — no subscription needed\nconst result = await client.callTool({\n  name: \"get_signal\",\n  arguments: {\n    query: \"Bitcoin 200K\",\n    x402_payment: {\n      tx_hash: \"0xabc...\",\n      network: \"base\",\n      rail: \"x402\",\n    },\n  },\n});\n```\n\n### Get an API key\n\n```bash\n# Via the MCP server itself (free tier, no signup)\n# Call the generate_api_key tool\n\n# Or via Telegram\n# Message @TeleKashBot with /apikey\n```\n\n## Example\n\nConnect to the server and query a market probability:\n\n```typescript\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\n\nconst transport = new StdioClientTransport({\n  command: \"npx\",\n  args: [\"telekash-mcp-server\"],\n});\n\nconst client = new Client({ name: \"my-agent\", version: \"1.0.0\" });\nawait client.connect(transport);\n\n// Get probability for a market\nconst result = await client.callTool({\n  name: \"get_probability\",\n  arguments: { query: \"Will Bitcoin hit $200K by end of 2026?\" },\n});\n\nconsole.log(result.content);\n// => { probability: { yes: 34, no: 66 }, confidence: { grade: \"HIGH\", score: 82 }, ... }\n```\n\nMore examples in the [`examples/`](./examples) directory:\n\n- `quick-start.ts` -- Connect, search, get probabilities\n- `arbitrage-scanner.ts` -- Find cross-source mispricings\n- `portfolio-scanner.ts` -- Scan markets and build a ranked portfolio\n- `market-monitor.ts` -- Watch a market and log probability changes\n\n## Environment Variables\n\nThe server works without any credentials (returns demo data). For live market access:\n\n```\nSUPABASE_URL=https://rrkjtdnxkscukexbsrue.supabase.co\nSUPABASE_ANON_KEY=your-anon-key\nTELEKASH_API_KEY=your-api-key              # Optional: enables paid tiers\nTELEKASH_PAYMENT_ADDRESS=0x...             # Optional: EVM wallet for x402 USDC payments\nTELEKASH_TON_ADDRESS=UQ...                 # Optional: TON wallet for TON payments\nSTRIPE_SECRET_KEY=sk_...                   # Optional: Stripe for fiat payments\nX402_FACILITATOR_URL=https://x402.org/facilitator  # Default: Coinbase facilitator\n```\n\n## Data Sources\n\n| Source     | Type                       | Sync Frequency   |\n| ---------- | -------------------------- | ---------------- |\n| Kalshi     | CFTC-regulated US exchange | Every 15 minutes |\n| Polymarket | Crypto-native exchange     | Every hour       |\n\nAll sources are aggregated, deduplicated, and categorized automatically across 8 categories: crypto, politics, sports, entertainment, finance, weather, tech, science.\n\n## Links\n\n- [npm](https://www.npmjs.com/package/telekash-mcp-server)\n- [GitHub](https://github.com/TeleKashOracle/mcp-server)\n- [Agent Card](https://github.com/TeleKashOracle/mcp-server/blob/main/agent-card.json)\n- [A2A Protocol](https://github.com/TeleKashOracle/mcp-server/blob/main/server.json)\n- [TeleKash Bot](https://t.me/TeleKashBot)\n\n## License\n\nMIT\n",
  "bytes": 10364,
  "sha": "2452f48b41c0d71f791d6f96df07d6be9b0524589aa52cef4abd96d568c16a4e",
  "repo_slug": "telekashoracle/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_telekashoracle_mcp_server_9d09c924/readme"
}