关于 Tradingcalc MCP
Tradingcalc MCP 为 AI Agent 提供可重复验证的交易与金融计算,涵盖加密货币期货、期权、外汇、风险统计、预测市场和链上分析。计算结果带有可离线验证的签名,并可用标准测试向量检查公式。
主要功能
- 01计算盈亏、清算价和仓位规模
- 02估算期权价格及希腊值
- 03计算 VaR、Sharpe 和风险指标
- 04分析预测市场赔率与套利
- 05检查 Solana 代币和钱包风险
- 06离线验证签名计算结果
适用场景
- 01估算杠杆期货的盈亏与清算风险
- 02按止损和风险预算计算外汇仓位
- 03分析收益序列的 VaR 或 Sharpe
- 04核验预测市场机会和链上风险
MCP 相关
该远程 MCP 服务通过 Streamable HTTP 暴露交易计算工具,供 Claude、Cursor、VS Code 等 MCP 客户端调用,也支持直接 HTTP 请求。计算响应带有 ECDSA P-256 签名,客户端可离线验证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://tradingcalc.io/api/mcpclaude mcp add --transport http tradingcalc https://tradingcalc.io/api/mcp{"mcpServers":{"tradingcalc":{"type":"http","url":"https://tradingcalc.io/api/mcp"}}}在 Cursor 中打开{"servers":{"tradingcalc":{"type":"http","url":"https://tradingcalc.io/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"tradingcalc":{"type":"http","url":"https://tradingcalc.io/api/mcp"}}}{"mcpServers":{"tradingcalc":{"serverUrl":"https://tradingcalc.io/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
23| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| side | enum | 是 | 交易方向long | short |
| entryPrice | number | 是 | 入场价格(正数) |
| exitPrice | number | 是 | 出场价格(正数) |
| size | number | 是 | 以基础资产计的持仓规模 |
| feeOpenPct | number | 否 | 开仓手续费比例,例如 0.0002 = 0.02% |
| feeClosePct | number | 否 | 平仓手续费比例 |
详细介绍
TradingCalc MCP Server
大模型会猜测交易数学结果。这个服务会精确计算:相同输入始终返回相同数字,每个结果都带有可验证的签名,核心公式也都经过公开测试向量验证(上方徽章显示实时数量)。
Your question MCP tool call Result
+------------------+ +---------------------------+ +---------------------------+
| "Risk $200 on | ► | workflow.run_forex_ | ► | 0.67 lots, plus an ECDSA |
| EUR/USD with a | | position_size_live | | P-256 signature you can |
| 30 pip stop" | | (deterministic maths) | | verify offline |
+------------------+ +---------------------------+ +---------------------------+
向 Claude、Cursor 或任何 MCP 客户端询问交易问题,即可获得准确数字,而不是猜测:
“行权价为 9 万美元、距离到期 30 天、隐含波动率为 55% 的 BTC 看涨期权,价值是多少?” “如果我愿意承担 200 美元风险,止损设为 30 点,应该交易多少手 EUR/USD?” “根据这组月度收益率序列,我的 95% 风险价值是多少?” “如果我以 8 万美元买入 0.5 BTC,再以 9.5 万美元卖出,使用 5 倍杠杆,我的盈亏是多少?”
涵盖范围(77 个工具)
| 领域 | 示例 |
|---|---|
| 期权 | Black-Scholes 价格和希腊字母(手动计算,或与 Deribit 上实时的 BTC/ETH 期权核验)、收益和盈亏平衡点、跨式和宽跨式策略、垂直价差、备兑看涨和保护性看跌策略、隐含波动率 |
| 外汇 | 根据风险金额计算仓位大小、点值、保证金、隔夜利息成本、货币换算、货币对相关性,并提供按账户货币计算的实时汇率版本 |
| 风险与统计 | VaR 和 CVaR、带 Lo 2002 修正的 Sharpe、Deflated Sharpe、Kelly 有效前沿、GARCH(1,1)、风险平价、Hurst 指数、协整、投资组合分析表、EVT 尾部风险 |
| 预测市场 | 赔率和抽水、市场隐含赔率、优势仓位计算,以及对 Kalshi、Polymarket、Limitless 和 Myriad 的价差与套利检查 |
| 链上 | Solana 代币和钱包检查、兑换价格影响、pump.fun 联合曲线、无常损失 |
| 加密货币现货 | 直接买入和卖出代币的盈亏,已计入买卖双方的手续费 |
| 加密货币期货 | 盈亏、强平价格、盈亏平衡点、资金费用、仓位大小、风险回报、线性合约和币本位合约 |
可通过 MCP(Claude Desktop、Cursor、VS Code 等客户端)访问,也可向 MCP 端点发送普通 HTTP POST 请求。无需注册。该服务是远程服务,因此除一行客户端配置外,无需安装任何内容;只有下方的 Claude Desktop 桥接程序需要 Node.js 18 或更高版本。
端点
| 接口 | URL | 身份验证 |
|---|---|---|
| MCP | https://tradingcalc.io/api/mcp | Bearer 可选(免费) |
| Agent / 配置 | https://tradingcalc.io/for-agents | 无 |
| 完整 API 和 MCP 参考文档 | https://docs.tradingcalc.io/api | 无 |
| 验证证明 | https://tradingcalc.io/verify | 无 |
MCP 传输方式:Streamable HTTP(MCP 规范 2024-11-05)
快速开始
每个客户端只需一条命令或一项配置。前置条件:一个 MCP 客户端;仅 Claude Desktop 桥接程序和技能安装器需要 Node.js 18 或更高版本。无需账户,无需 API 密钥。
| 客户端 | 安装方式 |
|---|---|
| Claude Code | claude mcp add --transport http tradingcalc https://tradingcalc.io/api/mcp |
| Gemini CLI | gemini extensions install https://github.com/SKalinin909/tradingcalc-mcp |
| 支持技能的编码 Agent(Claude Code、Cursor、Copilot) | npx skills add SKalinin909/tradingcalc-mcp |
| Claude Desktop、Cursor、VS Code | 使用下方的配置项 |
| 其他客户端 | 发送普通 HTTP POST 请求,参见下方“直接 HTTP” |
Claude Desktop
添加到 claude_desktop_config.json:
{
"mcpServers": {
"tradingcalc": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://tradingcalc.io/api/mcp"]
}
}
}
Cursor / VS Code
{
"tradingcalc": {
"url": "https://tradingcalc.io/api/mcp"
}
}
Agent 技能
适用于支持 skills.sh 生态系统的编码 Agent(Claude Code、Cursor、
GitHub Copilot 等)——安装一个 SKILL.md,教会 Agent 何时使用这些工具,而不是自行估算交易计算:
npx skills add SKalinin909/tradingcalc-mcp
直接 HTTP
curl -X POST https://tradingcalc.io/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "workflow.run_liquidation_safety",
"arguments": {
"side": "long",
"entryPrice": 95000,
"leverage": 10
}
}
}'
示例提示词
连接后,只需自然提问:AI 会自动选择合适的工具:
期权收益
“我的 BTC 看涨期权在 $90,000 时的收益是多少?行权价 $85,000,权利金 0.02 BTC,做多 1 份合约。”
Black-Scholes / IV 检查
“Deribit 的 BTC-27FEB27-90000-C 现在定价合理吗?”
备兑看涨期权收益率
“我持有以 $80,000 买入的 BTC。卖出一份行权价 $85,000、权利金 0.02 BTC、30 天后到期的看涨期权,年化收益率是多少?”
外汇点值
“在我的 USD 账户中,2 手 EUR/USD 的一个点值多少钱?”
外汇仓位规模
“如果我在 EUR/USD 上设置 30 点止损,要将风险控制在 $200,应该交易多少手?”
外汇保证金水平
“我的权益是 $5,000,已用保证金是 $1,800。我离保证金追缴还有多远?”
风险价值
“根据这组月度收益序列,我的 95% 风险价值和预期损失是多少?[粘贴收益数据]”
夏普比率
“考虑自相关修正后,这些月度收益的夏普比率是多少?”
协整
“这两条价格序列是否协整?是否存在配对交易机会?”
赔率转换
“35% 的概率对应什么赔率?”
市场隐含赔率
“市场认为 BTC 到年底会值多少钱?”
预测市场优势
“我认为这件事发生的概率是 60%,但市场定价为 40%。我该下注吗?如果该下注,$10k 本金应该下注多少?”
代币安全检查
“这个 Solana 代币有跑路风险吗?Mint:DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263”
兑换价格影响
“将 50,000,000 BONK 兑换成 USDC,我会承受多大的滑点?”
联合曲线
“在一个已募集 20 SOL 的 pump.fun 曲线上,用 1 SOL 买入能获得多少代币?”
市值对比
“如果我向 BONK 投入 $1,000,且它的市值达到 JUP 的市值,这笔投资值多少钱?”
钱包标记检查
“这个钱包地址是否有任何标记?[地址]”(Solana 或 EVM)
交易盈亏
“我以 $80,000 买入 0.5 BTC,想以 $95,000 卖出,使用 5 倍杠杆。扣除手续费后净利润是多少?”
仓位规模
“我有一个 $10,000 的账户,想做多 BTC,并将风险控制在 1%。入场价为 $83,000,止损价为 $81,000。我应该买入多少枚?”
强平检查
“以 $3,200 做多 ETH,使用 10 倍杠杆,我会在哪个价格被强平?”
完整交易前检查
“分析这个交易方案:以 $83,000 做多 BTC,止损价 $81,000,目标价 $90,000,账户 $10k,风险 1%,杠杆 5 倍。值得入场吗?”
资金费率成本
“我在 Bybit 以 $83,000 做多并持有 0.5 BTC,资金费率为 0.01%。持有 3 天的资金费用是多少?”
套息交易
“这笔套息交易值得做吗?在 Bybit 做多,资金费率为 0.01%;在 Binance 做空,资金费率为 0.05%;名义金额 $50k,持有 30 天。”
DCA 平均入场价
“我分别以 $78k 买入 0.2 BTC、以 $80k 买入 0.3 BTC、以 $82k 买入 0.1 BTC。我的平均入场价和盈亏平衡价是多少?”
分批平仓计划
“我以 $80k 做多 1 BTC,计划在 $88k 平仓 30%,在 $92k 平仓 40%,在 $96k 平仓 30%。我的总盈亏是多少?”
工具(77)
工具命名遵循 workflow.run_* / primitive.* / system.* 命名空间约定。
为保持向后兼容,也接受旧的扁平名称(pnl、liquidation 等)。所有工具均可通过 MCP 免费使用,无需注册;匿名用户每天可调用 100 次,使用免费 API 密钥每天可调用 200 次。
| 类别 | 工具 |
|---|---|
| 期权(Deribit BTC/ETH,以币结算) | 期权收益与盈亏平衡点、Black-Scholes 价格/Greeks(手动 + 实时)、跨式/宽跨式、垂直价差与铁鹰、备兑看涨/保护性看跌、隐含波动率求解器(7) |
| 外汇(报价货币 + 实时账户货币换算) | 点值、保证金水平、盈亏平衡点、PnL、风险/回报、情景分析、平均入场价、仓位大小、所需保证金、货币换算器、掉期/展期成本、相关性/对冲比率:手动 + 实时外汇汇率变体(17) |
| 风险/统计 | VaR/CVaR(+ 修正 VaR)、夏普比率(Lo 2002 + PSR)、Hurst 指数、协整、投资组合概览表、GARCH(1,1)、风险平价、去膨胀夏普比率、Kelly 增长-安全前沿、收益平滑反转、EVT 尾部风险、订单簿冲击(12) |
| 预测市场(Kalshi、Polymarket、Limitless、Myriad、ADI Predictstreet 加密货币类别) | 赔率转换器、市场隐含赔率、预测市场优势、窗口公允价值、跨平台价差读取器、跨平台套利(6) |
| 链上(Solana + 5 条 EVM 链,按工具计) | 代币风险检查、兑换价格影响、联合曲线、市值比较、钱包标记检查、无常损失(手动 + 实时)(7) |
| 交易规划 | PnL、盈亏平衡点、退出目标、情景分析、DCA 入场、分批退出、向下加仓(7) |
| 风险与保证金 | 强平安全性、仓位规模、最大杠杆、风险/回报(4) |
| 资金费率与套息 | 资金费成本、资金费套利、复利资金费、资金费盈亏平衡点、套息交易(5) |
| 市场结构(Market Profile) | 开盘分析、时段结构、价值迁移、突破确认(4) |
| 基础工具 | 平均入场价、对冲比率(2) |
| 加密货币现货 | 加密货币收益:计算现货交易扣除双边手续费后的收益或亏损(1) |
| 跨交易所 | 价格共识:某个永续期货价格与 7 家参考交易所的价格相差多少(1) |
| 综合决策 | 交易前检查(一次调用完成仓位规模 + 强平 + 盈亏平衡点 + 资金费 + 是否交易判断)、投资组合风险审查(2) |
| 系统 | system.verify - 运行规范测试向量并获取通过/失败报告;system.pubkey - 获取公钥,以便离线验证已签名的响应(2) |
完整的逐工具参考(每个工具的所有输入/输出架构、请求/响应示例和说明):docs.tradingcalc.io/api
统一了 17 家交易所的公式:Binance、OKX、Bybit、Aster、Hyperliquid、MEXC、KuCoin、Gate、Deribit、Kraken、HTX、WOO、Phemex、Blofin、Backpack、dYdX、Polymarket Perps。
速率限制
| 访问方式 | 每日请求数 | 价格 |
|---|---|---|
| 匿名 | 100 | 免费 |
| 免费 API 密钥 | 200 | 免费 |
本服务免费。需要更高限额的密钥?请发送邮件至 [email protected]。
传递密钥的方式:Authorization: Bearer <your-api-key>
自我验证
Agent 可在信任结果前验证所有规范测试向量:
{
"jsonrpc": "2.0", "id": 1,
"method": "tools/call",
"params": { "name": "system.verify", "arguments": {} }
}
响应:{ "status": "pass", "passed": N, "failed": 0, "total": N },其中 N 是当前规范向量的数量(顶部徽章显示实时数量)。
签名响应
system.verify 可证明公式正确,但无法证明你收到的特定响应未在传输途中被代理、缓存或 MITM 篡改。每个 tools/call 结果都带有第二个由 ECDSA P-256 签名的 content 块,以及 X-TradingCalc-Signature/Kid/Signed-At 标头。调用 system.pubkey(或 GET /api/mcp/pubkey)即可获取公钥(PEM + JWK)以及离线验证所需的规范字符串格式,无需回调。
验证状态也会每天签名一次,其 SHA-256 哈希会通过 Memo 交易写入 Solana 主网(tcalc1 {date} {hash}),每条记录都包含前一天的哈希。可在 GET https://tradingcalc.io/api/anchors 读取记录;最新记录及自行验证方法见 tradingcalc.io/verification。
使用场景
- 期权和外汇交易台:通过一次精确调用为期权定价、确定外汇头寸规模或检查保证金水平
- 量化研究:根据收益序列计算 Sharpe、VaR、协整和回撤统计数据,并与参考库交叉验证
- 交易机器人:每次交易前检查清算价格
- AI Agent:进行确定性的风险计算,避免幻觉风险
- 多 Agent 系统:在分析师 + 风险 + 执行工作流中直接接入风险管理 Agent
- 仪表盘:以编程方式嵌入计算功能
为什么采用确定性计算?
直接向大模型提问,得到的数字看似合理,却可能有误。TradingCalc MCP 返回精确计算结果:相同输入始终产生相同输出。金融数据不会有幻觉风险。
风险 Agent 封装
examples/risk-agent-wrapper.ts:用于风险门控交易执行的即用型 TypeScript 封装。
可与任何 Agent 框架集成(ElizaOS、CrewAI、AutoGen、Hummingbot、Freqtrade)。
import { RiskAgent, preTradeGate } from './examples/risk-agent-wrapper';
const agent = new RiskAgent({ apiKey: 'tc_your_key', minLiqDistancePct: 3.0 });
const result = await agent.evaluate({
symbol: 'BTCUSDT', exchange: 'bybit',
side: 'long', entry_price: 83000, stop_loss: 81000,
account_balance: 10000, risk_pct: 1, leverage: 5,
funding_rate: 0.0001, hold_hours: 24,
});
if (result.approved) {
// execute trade: result.recommended_size, result.liquidation_price
} else {
console.log('Rejected:', result.rejection_reason);
}
// Binary gate for execution bots
const ok = await agent.isSafe({ symbol: 'ETHUSDT', side: 'short', ... });
// Standalone function (minimal integration)
const { approved, size, liqPrice } = await preTradeGate({ ... }, 'tc_your_key');
TypeScript SDK
如需以代码为主进行集成,请使用 tradingcalc-sdk,而不是原始 JSON-RPC:
npm install tradingcalc-sdk
import { TradingCalcClient } from 'tradingcalc-sdk';
const tc = new TradingCalcClient({ apiKey: 'tc_your_key' });
// Workflows: orchestrated decisions
const check = await tc.workflows.preTradeCheck({ side: 'long', entry_price: 83000, leverage: 5, funding_rate: 0.0001, account_balance: 5000 });
// Primitives: single formula
const avg = await tc.primitives.averageEntry({ symbol: 'BTCUSDT', input: { fills: [{ price: 83000, quantity: 0.1 }] } });
// System
const report = await tc.system.verify();
tc.call() 可用于原始 MCP 访问。完整文档:npmjs.com/package/tradingcalc-sdk
链接
- 面向 Agent:tradingcalc.io/for-agents
- 完整文档(API 和 MCP 参考、方法论、架构、更新日志):docs.tradingcalc.io
- 验证证明:tradingcalc.io/verify
- 网页计算器:tradingcalc.io
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。