内容
# 电信现金 MCP 服务器
**AI 代理的预测市场概率预言机。**
[](https://www.npmjs.com/package/telekash-mcp-server)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://nodejs.org)
## 这是什么？
电信现金是面向代理经济的概率预言机。实时访问来自 Kalshi（受 CFTC 监管）和 Polymarket 的 4,500+ 个实时预测市场。结构化的交易信号、跨源套利检测、噪声过滤以及跨加密货币、政治、体育、娱乐、金融、天气、技术和科学的智能交易路由。
**有什么不同：**
- **多源** — Kalshi + Polymarket + 本地池，而非单一交易所
- **自我校准** — 普拉特缩放，带有每日重新校准周期和布里尔评分跟踪
- **通用支付层** — 代理按次支付，使用 USDC（Base/Polygon/Solana 通过 x402）、法定货币（Stripe）或 TON
- **28 种工具** — 从免费概率到带有 1% 佣金的经纪人执行
## 快速安装
```bash
npx telekash-mcp-server
```
### Claude 代码
```bash
claude mcp add telekash-oracle npx telekash-mcp-server
```
### Claude 桌面 / Cursor
将以下内容添加到您的 MCP 配置文件中：
```json
{
"mcpServers": {
"telekash-oracle": {
"command": "npx",
"args": ["telekash-mcp-server"]
}
}
}
```
## 工具
4 类别共 28 种工具。所有工具在免费层（每天 100 次查询）无需 API 密钥。4,500+ 个实时市场。
### 情报
| 工具 | 功能 | 层级 |
| ------------------ | ------------------------------------------------------------ | ----------- |
| `get_probability` | 实时 YES/NO 概率，带有量加权置信度评分 | 免费 |
| `list_markets` | 按类别、来源、管辖权浏览市场，支持排序 | 免费 |
| `search_markets` | 跨 4,500+ 个市场的全文搜索 | 免费 |
| `get_history` | 1 小时、24 小时、7 天、30 天内的历史概率变化 | 免费 |
| `get_sentiment` | 带有信念、动量和噪声过滤的 AI 情绪分析 | 免费 |
| `get_market_stats` | 跨所有市场和来源的聚合统计数据 | 免费 |
| `get_trending` | 概率变化最大的市场 | 免费 |
| `compare_sources` | Kalshi 与 Polymarket 的赔率对比 | 校准 |
### 分析
| 工具 | 功能 | 层级 |
| ------------------ | ------------------------------------------------------------ | ----------- |
| `detect_arbitrage` | 跨源套利机会，带有买卖信号 | 校准 |
| `get_signal` | 结构化 TPF 信号：概率 + 情绪 + 噪声过滤 + 裁决 | 校准 |
| `get_divergences` | 来源分歧最大的市场 | 校准 |
| `get_edge` | 凯利准则大小、预期价值和风险分类 | 校准 |
| `track_prediction` | 记录预测以跟踪准确性 | 校准 |
| `get_performance` | 布里尔评分、校准曲线、优势与市场分析 | 校准 |
### 交易
| 工具 | 功能 | 层级 |
| ----------------------- | ------------------------------------------------------------ | ---- |
| `execute_trade` | 将交易路由到 Kalshi、Polymarket 或本地配对池 | 优势 |
| `get_order_status` | 检查订单的成交状态、价格和佣金 | 优势 |
| `cancel_order` | 取消待处理或已提交的经纪人订单 | 优势 |
| `get_pool_status` | 本地池的组成、参与者数量和隐含赔率 | 优势 |
| `get_agent_balance` | 代理余额、盈亏、胜率和池位置计数 | 优势 |
| `get_resolution_status` | 跨源解析验证和置信度水平 | 优势 |
| `create_market` | 创建自定义二进制预测市场 | 优势 |
| `export_data` | 批量导出：概率历史、解析、目录、套利 | 优势 |
### 管理
| 工具 | 功能 | 层级 |
| ------------------ | ------------------------------------------------------------ | ---- |
| `generate_api_key` | 生成免费的 API 密钥（无需注册） | 免费 |
| `get_usage` | 检查当前 API 用量、速率限制和层级状态 | 免费 |
| `register_alert` | 概率交叉、错误定价、交易量激增的 webhook 警报 | 优势 |
| `list_alerts` | 列出活跃的 webhook 警报，带有交付统计 | 优势 |
| `delete_alert` | 删除 webhook 警报 | 优势 |
| `get_health` | 系统健康状况：连接性、数据新鲜度、经纪人状态 | 免费 |
## 定价
按查询定价。无订阅。免费层级无需 API 密钥。
| 层级 | 费用 | 每日查询次数 | 您将获得 |
| --------------- | ----------- | ----------- | ----------------------------------------------------------------------------------------------- |
| **免费** | $0 | 100 | 概率、搜索、趋势、情绪、统计数据、健康状况 |
| **校准** | $0.01/query | 1,000 | + 跨源比较、套利、信号、分歧、凯利规模、性能跟踪 |
| **优势** | $0.05/query | 无限制 | + 经纪人交易（1% 佣金）、本地池（5% 费用）、webhook、数据导出、市场创建 |
### 收入模式
| 收入来源 | 费率 | 描述 |
| -------------------- | -------------------- | --------------------------------------------------- |
| 情报查询 | $0 - $0.05/query | 实时概率、情绪、信号 |
| 经纪人交易 | 1% 佣金 | 最佳价格执行，路由到 Kalshi 或 Polymarket |
| 本地池交易 | 5% 费用（解析时） | 与 Telegram 用户一起使用的配对池 |
### 通用支付层
代理也可以无需 API 密钥或层级直接支付 - 在工具参数中附加支付证明。
| 支付方式 | 网络 | 资产 | 费用 |
| ------------------- | --------------------- | ----------------- | --------- |
| **x402** (Coinbase) | Base, Polygon, Solana | USDC | 免费（0%） |
| **Stripe MPP** | 法定货币 | 美元（信用卡，银行） | 2.9% |
| **TON** | TON 主网 | TON | 免费（0%） |
```typescript
// 代理按次支付 - 无需订阅
const result = await client.callTool({
name: "get_signal",
arguments: {
query: "比特币 200K",
x402_payment: {
tx_hash: "0xabc...",
network: "base",
rail: "x402",
},
},
});
```
### 获取 API 密钥
```bash
# 通过 MCP 服务器本身（免费层级，无需注册）
# 调用 generate_api_key 工具
# 或通过 Telegram
# 给 @TeleKashBot 发送 /apikey 消息
```
## 示例
连接到服务器并查询市场概率：
```typescript
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);
// 获取市场的概率
const result = await client.callTool({
name: "get_probability",
arguments: { query: "比特币是否会在 2026 年底达到 200K？" },
});
console.log(result.content);
// => { probability: { yes: 34, no: 66 }, confidence: { grade: "HIGH", score: 82 }, ... }
```
更多示例位于 [`examples/`](./examples) 目录中：
- `quick-start.ts` -- 连接、搜索、获取概率
- `arbitrage-scanner.ts` -- 查找跨源错误定价
- `portfolio-scanner.ts` -- 扫描市场并建立排名投资组合
- `market-monitor.ts` -- 监控市场并记录概率变化
## 环境变量
服务器无需任何凭证即可运行（返回演示数据）。对于实时市场访问：
```
SUPABASE_URL=https://rrkjtdnxkscukexbsrue.supabase.co
SUPABASE_ANON_KEY=your-anon-key
TELEKASH_API_KEY=your-api-key # 可选：启用付费层级
TELEKASH_PAYMENT_ADDRESS=0x... # 可选：EVM 钱包用于 x402 USDC 支付
TELEKASH_TON_ADDRESS=UQ... # 可选：TON 钱包用于 TON 支付
STRIPE_SECRET_KEY=sk_... # 可选：Stripe 用于法定货币支付
X402_FACILITATOR_URL=https://x402.org/facilitator # 默认：Coinbase 促进者
```
## 数据来源
| 来源 | 类型 | 同步频率 |
| ---------- | -------------------------- | ---------------- |
| Kalshi | 受 CFTC 监管的美国交易所 | 每 15 分钟 |
| Polymarket | 加密原生交易所 | 每小时 |
所有来源均自动聚合、重复数据删除并分类到 8 个类别：加密货币、政治、体育、娱乐、金融、天气、技术、科学。
## 链接
- [npm](https://www.npmjs.com/package/telekash-mcp-server)
- [GitHub](https://github.com/TeleKashOracle/mcp-server)
- [代理卡](https://github.com/TeleKashOracle/mcp-server/blob/main/agent-card.json)
- [A2A 协议](https://github.com/TeleKashOracle/mcp-server/blob/main/server.json)
- [电信现金机器人](https://t.me/TeleKashBot)
## 许可证
MIT
