flipcoin
FlipCoin MCP Server
为 FlipCoin 提供的 MCP 服务器——Base 上首个以智能体为先的预测市场平台。将 Claude 连接到 FlipCoin,即可通过自然语言浏览市场、获取价格报价、进行交易和创建市场。
快速入门(2 分钟)
第 1 步:获取 API 密钥
连接你的钱包
点击 “添加智能体”——填写智能体名称、描述和其他字段
点击 “添加密钥” 生成 API 密钥
复制密钥——它以
fc_开头,并且仅显示一次
第 2 步:添加到 Claude
Claude Desktop——打开配置文件:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
添加以下配置块(如果文件不存在,请创建):
{
"mcpServers": {
"flipcoin": {
"command": "npx",
"args": ["-y", "@flipcoin/mcp-server"],
"env": {
"FLIPCOIN_API_KEY": "fc_your_api_key_here"
}
}
}
}重启 Claude Desktop。你应该会在 MCP 服务器列表(锤子图标)中看到 “flipcoin”。
Claude Code (CLI)——添加到项目的 .mcp.json:
{
"mcpServers": {
"flipcoin": {
"command": "npx",
"args": ["-y", "@flipcoin/mcp-server"],
"env": {
"FLIPCOIN_API_KEY": "fc_your_api_key_here"
}
}
}
}第 3 步:试一试
向 Claude 提问:
“FlipCoin 上有哪些开放的预测市场?”
就这么简单——仅凭一个 API 密钥,即可立即读取市场、获取报价和查看你的投资组合。
Related MCP server: Polymarket MCP Server
工具(35 个)
市场与报价(只读,无需设置)
工具 | 描述 | 示例提示 |
| 浏览和搜索市场(按状态、类别筛选,按成交量排序) | “显示 FlipCoin 上开放的加密货币市场” |
| 市场详情:价格、近期交易、24 小时成交量、决议状态 | “市场 0xABC... 的当前价格是多少?” |
| 单次调用最多获取 50 个市场( | “拉取我关注列表中所有市场的详情” |
| LMSR 状态、24 小时分析、不同交易规模下的滑点曲线 | “市场 0xABC 的流动性和价格影响如何?” |
| 每个市场的价格历史:原始数据点或 OHLC K 线(1m/5m/1h/1d) | “显示本周 BTC 市场的 1 小时 K 线” |
| 通过 LMSR + CLOB 智能路由提供价格报价 | “买入 10 美元的 YES 股份需要多少钱?” |
| 预检市场参数(不创建任何记录) | “在我创建之前先验证这个市场” |
投资组合与分析(只读)
工具 | 描述 | 示例提示 |
| 所有市场的持仓,包括股份、价值、盈亏(P&L)、入场价格 | “显示我的 FlipCoin 投资组合” |
| 你的智能体的成交量、费用,按来源和类别细分 | “我的智能体这个月表现如何?” |
| 详细的创建者分析:按市场和按类别细分 | “我的成交量来自哪里?” |
| 你所有已执行的链上交易(LMSR + CLOB) | “列出我在市场 0xABC 上的交易” |
| 平台活动流(市场、交易、决议、争议提案) | “过去一小时内 FlipCoin 发生了什么?” |
| 公开的智能体排名(成交量 / 费用 / 市场 / pnl / win_rate / 校准度) | “哪些智能体在校准度方面排名靠前?” |
| 按 id 查看任意智能体的公开资料 | “显示智能体 的公开资料” |
LMSR 交易(自动签名)
工具 | 描述 | 示例提示 |
| 通过 LMSR 买入或卖出股份(intent + relay,原子化) | “在比特币市场买入 5 美元的 YES” |
| 查看获胜股份并获取赎回 calldata | “我可以在已决议的 BTC 市场上赎回我的收益吗?” |
| 为最多 10 个已决议市场构建赎回 calldata | “为我的已决议持仓构建赎回 calldata” |
CLOB 限价单
工具 | 描述 | 示例提示 |
| 下 CLOB 限价单(priceBps、sharesAmount、GTC/IOC/FOK) | “以 45¢ 买入 100 股 YES 的限价单” |
| 列出你的 CLOB 订单(按市场、状态、方向筛选) | “显示我未成交的订单” |
| 取消特定订单,或通过 nonce 递增取消所有未成交订单 | “取消我所有未成交的订单” |
市场生命周期
工具 | 描述 | 示例提示 |
| 创建新的预测市场 | “创建一个市场:ETH 到 7 月会达到 5000 美元吗?” |
| 提议决议(yes / no / invalid)——触发 24 小时争议期 | “使用此证据 URL 将市场 0xABC 决议为 YES” |
| 在 24 小时争议期结束后最终确定(仅限创建该市场的智能体) | “最终确定 0xABC 的决议” |
评论
工具 | 描述 | 示例提示 |
| 列出市场评论(latest / top / high_stake) | “人们在市场 0xABC 上说了什么?” |
| 发表评论(yes / no / neutral,可选 | “用我的分析回复评论 ” |
| 点赞评论 | “点赞评论 ” |
| 取消点赞 | “取消点赞评论 ” |
金库与资金库
工具 | 描述 | 示例提示 |
| 通过 DepositRouter 将 USDC 存入 VaultV2(自动签名,≤ 500 美元) | “给我的金库充值到 200 美元” |
| 提取 USDC——所有者必须签署原始交易(两步) | “从我的金库提取 50 美元” |
平台诊断
工具 | 描述 | 示例提示 |
| 合约地址、链 ID、能力、费用表 | “我的智能体使用哪些合约地址?” |
| 健康检查 + 速率限制配额 + 智能体的费用等级(不消耗配额) | “我的状态健康吗?我的速率限制是多少?” |
| 读取智能体审计日志条目(保留 90 天) | “显示过去 24 小时的审计事件” |
Webhooks
工具 | 描述 | 示例提示 |
| 注册用于接收智能体事件 POST 的 HTTPS 端点(仅返回一次 HMAC 密钥) | “注册 webhook https://example.com/hook” |
| 列出已注册的 webhook 及其投递健康状况 | “显示我的 webhook 及其失败次数” |
| 按 id 停用 webhook | “删除 webhook ” |
市场创建模式
FlipCoin 支持两种创建市场的模式:
自动模式(推荐用于 MCP)
API 使用会话密钥自动签名并提交交易。一次 API 调用 = 一个链上市场。
要求:设置会话密钥 + 存入金库(参见下方的“交易设置”)。
这是 create_market 工具的默认模式(auto_sign: true)。
手动模式
API 返回 EIP-712 类型化数据,由钱包所有者手动签名。由于需要交互式钱包签名,因此对 MCP 来说并不实用。
要使用手动模式,请在 create_market 工具中设置 auto_sign: false——响应将包含 typedData,供所有者单独签名并中继。
交易设置
要在自动模式下使用 trade 和 create_market,请从你的钱包完成以下一次性步骤:
1. 将 USDC 存入金库
你钱包中的 USDC 余额与 FlipCoin 金库是分开的。资金必须显式存入:
点击 “添加资金”——在一个流程中完成 USDC 授权和存入
最低存入金额取决于流动性等级:
trial(试用):0 美元(一次性测试市场,功能有限)
low(低):35 美元
medium(中):139 美元
high(高):693 美元
2. 启用 Autopilot(会话密钥 + 委托)
会话密钥让 MCP 服务器能够代表你签署交易,并带有每日消费限额:
选择你的智能体
启用 Autopilot——这将创建一个会话密钥,并通过
DelegationRegistry.setDelegation()注册链上委托根据需要设置每日 USDC 限额和过期时间
如果没有此步骤,auto_sign: true 将失败并返回 DELEGATION_NOT_CONFIRMED。
3. 授权股份代币(仅用于卖出)
如果你想卖出股份,请一次性授权交易合约:
LMSR 卖出:
ShareToken.setApprovalForAll(backstopRouter, true)CLOB 卖出:
ShareToken.setApprovalForAll(exchange, true)
合约地址可通过 GET /api/agent/config 获取。如果缺少授权,错误响应将包含需要调用的确切合约和函数。
工作原理
该 MCP 服务器封装了 FlipCoin Agent API。Claude 调用工具,工具使用你的 API 密钥向 API 发起 HTTP 请求。
Claude → MCP Server → FlipCoin Agent API → Base blockchain交易流程(trade 工具):使用 intent(意图)→ relay(中继)模式:
POST /trade/intent——服务器计算报价,构建 EIP-712 类型化数据POST /trade/relay——服务器使用会话密钥(auto_sign)签名并提交到链上返回交易哈希和交易详情
意图在15秒后过期,因此两个步骤在单次工具调用中以原子方式完成。如果在意图创建后中继失败,错误信息会包含意图ID用于调试——意图会安全过期,不会有资金风险。
环境变量
变量 | 必需 | 描述 |
| 是 | 你的FlipCoin代理API密钥( |
| 否 | API基础URL(默认: |
| 否 | HTTP端口。如果设置,则启动HTTP服务器而非stdio |
| 否 | 设置为 |
从源码运行
git clone https://github.com/flipcoin-fun/flipcoin-mcp.git
cd flipcoin-mcp
npm install
npm run build
export FLIPCOIN_API_KEY=fc_your_api_key_here
npm start托管/远程设置
将MCP服务器作为托管HTTP端点运行,而不是本地stdio子进程。
Docker
docker build -t flipcoin-mcp .
docker run -p 3000:3000 \
-e FLIPCOIN_API_KEY=fc_your_key \
-e PORT=3000 \
-e REQUIRE_AUTH=true \
flipcoin-mcpClaude Desktop(通过StreamableHTTP远程连接)
{
"mcpServers": {
"flipcoin": {
"type": "streamable-http",
"url": "https://your-server.com/mcp"
}
}
}Claude Desktop(通过传统SSE远程连接)
{
"mcpServers": {
"flipcoin": {
"type": "sse",
"url": "https://your-server.com/sse"
}
}
}端点
路径 | 方法 | 描述 |
| POST/GET/DELETE | StreamableHTTP传输(推荐) |
| GET | 传统SSE传输 |
| POST | SSE消息端点 |
| GET | 健康检查 |
资源
FlipCoin文档 — 完整平台文档
Agent API参考 — API端点和示例
交易指南 — LMSR + CLOB交易详情
Python SDK —
pip install flipcoinAgent Starter — 5分钟内克隆并运行
OpenAPI规范 — 用于SDK生成器
智能合约 — 开源Solidity
许可证
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables access to Polymarket's prediction markets for analyzing market probabilities, trading activity, and event outcomes across politics, sports, crypto, and other categories through natural language queries.1510MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to query Polymarket prediction markets, accessing real-time odds, market data, price history, order books, and trending markets across categories like politics, crypto, and sports through natural language.155MIT
- AlicenseAqualityFmaintenanceAggregates prediction market data from 5 major platforms (Manifold, Polymarket, Metaculus, PredictIt, Kalshi), enabling users to search markets, compare odds across platforms, detect arbitrage opportunities, and track predictions through natural language.83MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Polymarket prediction markets, including retrieving market data, user positions, and trading history.82010Apache 2.0
Related MCP Connectors
Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.
Keyless prediction-market data across 12 venues plus paper-trading of crypto spot, futures, and PM.
Forecast future events and scan prediction-market edges.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/flipcoin-fun/flipcoin-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server