swop

Swop MCP

あらゆる MCP クライアントから、USDC で支払いを受け、ユーザーや AI エージェントに販売できます。

接続先： https://mcp.swopme.co/mcp/commerce（Streamable HTTP） 公開ツールはアカウント不要です。アカウント用ツールでは OAuth 2.1（動的クライアント登録、PKCE）を使用します。 レジストリ：io.github.Travisswop/swop

• 商品を作成してリンクを1つ取得できます。ユーザーには購入ページが表示され、エージェントには x402 USDC チャレンジが表示されます
• Swop SmartSite で商品を紹介できます
• 署名付き Webhook（checkout.paid、payout.released）を使って、自分のサイトでチェックアウトできます
• 任意の swop.id のストアから商品を閲覧して購入できます
• 注文、SmartSite の編集、swop.id の検索

販売者は商品を追加するとすぐに、認証手続きなしで USDC によるエージェント決済を受けられます。

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：ユーザーとエージェントの両方に商品を販売するリンク

販売（スコープ 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枚の画像を含む公開投稿を作成します。 2段階の手順です。プレビューで封印された previewId が返されます。確定時には同一のコンテンツを再送信し、各プレビューは最大1回だけ公開されます。画像はバックエンドでホストされ、このサーバーはアップロードを行いません。

アカウント（スコープ 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）

既存の Swop ユーザー向けに、https://mcp.swopme.co/mcp も引き続き利用できます。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 push ではデプロイされません。レジストリエントリ：server.json。mcp-publisher publish で公開されます。

このプロジェクトの位置づけ

プラットフォームにおける AI アシスタント向けの接点です。MCP を話すあらゆるものに Swop を公開し、ファーストパーティークライアントが使用するものと同じ API に接続します。

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

ここで重要な ID のルールは、暗号資産による支払いに KYC は決して必要ありません。 エージェントは認証手続きなしで、販売者に USDC で支払えます。認証が必要なのはカードのスコープのみです。暗号資産を使う経路で本人確認を求めないでください。

リポジトリ横断の構成については、swop-app-backend/docs/ECOSYSTEM.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。

Ask Swop の読み取りコネクター

完全版の /mcp エンドポイントでは、アプリおよび Messages の Ask Swop と同じ検証済みアダプターを使用して、swop_get_token_price、swop_get_sports、swop_get_help を利用できるようになりました。3 つすべての利用には、リンク済みアカウントの profile.read スコープが必要で、資金を移動することはできません。swop_get_help は /mcp/commerce でも利用できますが、価格とスポーツは完全版エンドポイントでのみ利用できます。トークンの正確なコントラクトとネットワーク名はそのまま保持されます。プロバイダーの障害や曖昧な資産については、価格、スコア、または市場を捏造せず、説明を返します。

プロトコル、認証、入力検証、エンドポイントの分離に関するチェックを実行するには、npm run build && node scripts/test-assistant-connectors.mjs を実行してください。

既存の Ovi 戦略の改訂

OAuth の agent.read および agent.write スコープを使用して、完全版の /mcp エンドポイントを利用します。更新後は、コネクターのツールリストを更新してください。コマース専用エンドポイントと一般公開の読み取り専用コネクターでは、エージェントの操作は利用できません。

1. swop_get_my_agent を読み取り、正確な戦略 ID、現在のルール、上限を確認します。
2. swop_resolve_strategy_markets でリクエストされた市場を解決します。例：{"request":"trade gold, ETH and any stock"}。株式の検索では、サポート対象の株式原資産カタログを使用し、現在の Hyperliquid の上場銘柄に照らして絞り込みます。すべての builder-DEX 市場を株式として扱うことも、担保への資金追加が済んでいると判断することもありません。
3. action: "revise_strategy"、strategyId、および希望する assets、title、brief、entryCondition、exitCondition、selectionCriteria、executionPlan、または riskControls を含む revision を指定して、swop_update_my_agent を呼び出します。矛盾する古い単一市場の記述がある場合は、市場リストとあわせて更新してください。省略したフィールドは変更されません。金額の上限、権限、資金調達、ランタイムは、このアクションでは変更できません。
4. 返された差分とリスクに関する注記をすべて提示します。オーナーから明示的な承認を得た後、previewId と confirm: true のみを指定して再度呼び出します。

プレビューは一度だけ使用でき、有効期限は 5 分間で、オーナーと OAuth クライアントに紐づけられます。ルールまたは上限を同時に編集すると、プレビューは無効になります。実行中のプランは、以降の評価で改訂後のルールを使用します。編集しても注文が保証されることはなく、市場、担保、リスクのチェックを回避することもできません。