swop

Swop MCP

通过任意 MCP 客户端向用户和 AI Agent 销售商品，以 USDC 收款。

连接： https://mcp.swopme.co/mcp/commerce（Streamable HTTP） 公共工具无需账号；账号工具使用 OAuth 2.1（动态客户端注册、PKCE）。 注册表：io.github.Travisswop/swop

• 创建商品并获取一个链接：用户看到购买页面，Agent 会收到 x402 USDC 挑战
• 在你的 Swop SmartSite 上展示商品
• 在你自己的网站上结账，并使用签名 Webhook（checkout.paid、payout.released）
• 浏览和购买任意 swop.id 商店中的商品
• 订单、SmartSite 编辑、swop.id 查询

卖家添加商品后即可通过 USDC 向 Agent 收款，无需验证。

Claude、ChatGPT、Cursor 和 Grok 的设置指南：docs/add-swop-to-your-ai.md

claude mcp add --transport http swop https://mcp.swopme.co/mcp/commerce

工具（/mcp/commerce）

公共工具，无需账号：

• swop_search_identities、swop_lookup_identity：将 swop.id 转换为个人资料和钱包地址
• swop_get_store：获取任意卖家的商品、USDC 价格，以及每件商品的 x402 购买 URL
• swop_get_product_link：向用户和 Agent 销售商品的单一链接

销售（作用域 commerce.write）：

• swop_create_product、swop_update_product、swop_list_my_products、swop_feature_product

在你自己的网站上结账（作用域 commerce.write）：

• swop_create_checkout、swop_get_checkout
• swop_register_webhook、swop_list_webhooks、swop_test_webhook、swop_remove_webhook （HMAC 签名的 checkout.paid / payout.released）
• swop_register_embed_origin、swop_list_embed_origins、swop_remove_embed_origin

SmartSite 店面（作用域 smartsite.write）：

• swop_get_my_smartsite、swop_update_my_smartsite、swop_add_link、swop_remove_link
• swop_create_feed_post：以关联的 SmartSite 身份发布公开帖子，包含说明文字和最多 4 张图片。 分两步操作：预览会返回密封的 previewId；确认时会重新发送完全相同的内容， 每个预览最多发布一次。图片由后端托管；此服务不会上传图片。

账号（作用域 profile.read、wallet.read）：

• swop_get_my_profile、swop_get_my_orders、swop_get_my_balances、 swop_list_my_tokens（商店积分“Bucks”）

commerce 端点没有发送资金的工具。其 OAuth 元数据 （/.well-known/oauth-protected-resource/mcp/commerce）仅公布 profile.read wallet.read smartsite.write commerce.write。

完整端点（/mcp）

https://mcp.swopme.co/mcp 仍为现有 Swop 用户提供服务。它包含 commerce 工具集，以及钱包和市场工具（转账、x402 支付、兑换、 永续合约和预测市场数据）；涉及资金操作的工具需要所有者在 Swop 应用中启用 AI 支出并设置限额。新设置应使用 /mcp/commerce。 同一个 OAuth 链接可用于两个端点。

运行

npm install
npm run dev          # Streamable HTTP on :8788 (POST /mcp and /mcp/commerce), stateless JSON mode
npm run dev:stdio    # stdio transport for local clients
npm run build && npm start
npm run smoke        # endpoint smoke test (in-process); `npm run smoke -- https://mcp.swopme.co` for prod

环境变量：SWOP_API_BASE（默认值为 https://apps.apiswop.co）、`PREDICTIONS_API_BASE` （默认值为 https://polymarket.apiswop.co）、`PUBLIC_BASE_URL`（默认值为 https://mcp.swopme.co）、`PORT`（默认值为 8788）。

使用 Claude Code 在本地测试：

claude mcp add swop --transport http http://localhost:8788/mcp/commerce

部署

无状态 Vercel 函数（项目 swop-mcp），服务地址为 mcp.swopme.co （绝不使用 swop.tech）。仅通过 vercel deploy --prod 部署；推送 git 不会发布该服务。注册表条目：server.json，使用 mcp-publisher publish 发布。

适用场景

平台面向 AI 助手的一端。它将 Swop 提供给任何支持 MCP 的工具，并接入所有第一方客户端使用的同一 API。

graph LR
    ai["Claude / ChatGPT / Cursor"] --> mcp["<b>swop-mcp</b>"]
    mcp --> api["swop-app-backend<br/>apps.apiswop.co"]

此处重要的身份规则：加密货币支付绝不会受 KYC 限制。 Agent 无需验证即可用 USDC 向卖家付款。只有银行卡作用域受验证限制；加密货币支付流程绝不要索要身份信息。

跨仓库概览请参阅 swop-app-backend/docs/ECOSYSTEM.md。

许可证

MIT — 参见 LICENSE。

Ask Swop 读取连接器

完整的 /mcp 端点现在提供 swop_get_token_price、swop_get_sports 和 swop_get_help，使用的适配器与应用和 Messages 中的 Ask Swop 相同。三者都要求 关联账户具有 profile.read 权限范围，且不能转移资金。swop_get_help 也可通过 /mcp/commerce 使用；价格和体育信息仍仅在完整端点提供。令牌合约和网络名称会 原样保留。提供方故障和含糊不清的资产会返回说明，而不是虚构价格、比分或市场。

运行 npm run build && node scripts/test-assistant-connectors.mjs，检查协议、 身份验证、输入校验和端点隔离。

修改现有 Ovi 策略

使用完整的 /mcp 端点，并授予 OAuth agent.read 和 agent.write 权限范围。 更新后刷新连接器的工具列表；仅限 commerce 的端点和公开的只读连接器不提供 Agent 控制功能。

1. 调用 swop_get_my_agent，读取确切的策略 ID、当前规则和限制。
2. 使用 swop_resolve_strategy_markets 解析所请求的市场，例如 {"request":"trade gold, ETH and any stock"}。股票发现功能会使用受支持的 股票标的目录，并根据当前 Hyperliquid 上市情况进行筛选。它不会将所有 builder-DEX 市场都视为股票，也不会确认抵押品已入金。
3. 调用 swop_update_my_agent，传入 action: "revise_strategy"、strategyId， 以及包含所需 assets、title、brief、 entryCondition、exitCondition、selectionCriteria、executionPlan 或 riskControls 的 revision。更新市场列表时，也要一并更新与之矛盾的旧版单一市场描述。省略的字段保持不变；此操作无法修改美元限额、权限、资金和运行时。
4. 显示完整的返回差异和风险提示。所有者明确批准后，再次调用，但只传入 previewId 和 confirm: true。

预览只能使用一次，有效期为五分钟，并绑定到所有者和 OAuth 客户端。并发修改规则或 限制会使其失效。运行中的计划会在后续评估时采用修订后的规则；修改并不保证会下单， 也不会绕过市场、抵押品或风险检查。