agent-commerce-mcp

Agent Commerce MCP

エージェントネイティブなストアフロントで、14 種類の SaaS／開発者向け／サービス製品と 9 つの MCP サーバーを提供します。 検索、価格確認、認証済みチェックアウト、アフィリエイトプログラム（継続報酬 15～30％）、AgentTrust による検証を、単一の MCP サーバー経由で利用できます。

これは実際に稼働する A2A コマースレイヤーです。他の AI エージェントは、Halverson IQ ポートフォリオの製品を匿名で検索、問い合わせ、比較できます。状態を変更する書き込みツールは、書き込みトークンを設定した場合にのみ公開されます。

インストール

Claude Desktop／Cursor／Cline — MCP 設定に追加します：

{
  "mcpServers": {
    "agent-commerce-mcp": {
      "command": "npx",
      "args": ["-y", "agent-commerce-mcp"]
    }
  }
}

Claude Code：

claude mcp add commerce npx -y agent-commerce-mcp

リモート（Streamable HTTP）：

https://commerce.halversonco.com/mcp

（DNS の設定が完了すると、カスタムドメイン commerce.halversonco.com が解決されます。）

設定

公開読み取り専用ツールは、デフォルトで匿名利用できます。AGENT_COMMERCE_WRITE_TOKEN（または旧 MCP_WRITE_TOKEN）を設定すると、状態を変更するツールが公開され、実行可能になります：

• create_checkout
• register_affiliate
• request_partnership
• request_product_consultation

書き込みトークンが設定されていない場合、これらのツールは公開されず、直接呼び出してもフェイルクローズで拒否されます。トークンが設定されている場合、HTTP クライアントは次のいずれかを送信する必要があります：

Authorization: Bearer <AGENT_COMMERCE_WRITE_TOKEN>

または：

X-Agent-Commerce-API-Key: <AGENT_COMMERCE_WRITE_TOKEN>

Salesbot の POST /leads/capture URL を SALESBOT_LEAD_CAPTURE_URL に設定すると、オプトインによる相談内容の取得が有効になります。未設定の場合、相談リクエストはフェイルクローズで失敗し、取得済みとして報告されません。

リモート HTTP サーバーは、クライアントごとに MCP リクエストをレート制限し、メモリ内のアクティブな MCP セッション数を制限します。デフォルトでは直接接続のソケット IP を使用します。プロセスの前段に信頼できるリバースプロキシが 1 つだけある場合に限り、TRUST_PROXY=true を設定してください。その場合、Express は転送ヘッダーを直接信頼するのではなく、その 1 ホップのポリシーに基づいて req.ip を決定します。

ツール

検索

• search_products(query, category?, budget_max?, use_case?) — 関連度順の検索結果
• get_recommendation(problem, stack?, company_size?) — 理由付きの最適候補 1～3 件
• compare_products(slugs, vs_competitor?) — 機能／価格の比較表

購入

• get_pricing(product_slug, tier?, billing?) — 詳細な価格内訳
• create_checkout(product_slug, tier, email, referral_code?) — 認証済みチェックアウト URL
• get_free_tier(product_slug) — すぐに利用可能（登録 URL またはインストールコマンド）
• get_mcp_install(product_slug, client) — claude_desktop／claude_code／cursor／cline／windsurf 用の正確なインストール設定

購入者向け相談（明示的なオプトインがある場合のみ）

• request_product_consultation(product_slug, email, name?) — AgentFetch、QueryShield、または Agent Commerce に関する問い合わせを依頼します。購入者が連絡を明示的に希望した後にのみ呼び出してください

アフィリエイト

• get_affiliate_info(product_slug?) — 報酬率とティア
• register_affiliate(agent_id, operator_email, products?) — 即時登録し、紹介コードを返します
• request_partnership(proposal, agent_id, contact_email, integration_type?) — パートナーシップの手続きを開始します

クロスセルと信頼性

• get_cross_sells(current_product, agent_context?) — グラフに基づく関連製品とおすすめのバンドル
• get_trust_score() — ベンダーの評判を確認するため、AgentTrust MCP を呼び出します
• verify_vendor() — ベンダー情報、公開中の製品、返金／データに関するポリシー

リソース

commerce://catalog/all
commerce://catalog/saas
commerce://catalog/developer
commerce://catalog/services
commerce://catalog/mcp-servers
commerce://product/{slug}
commerce://bundle/{slug}
commerce://affiliate/program

プロンプト

elevator_pitch · full_pitch · objection_handler · bundle_pitch

カタログの内容

SaaS： CastIQ · GrantIQ · FocusIQ · Catholic Daily 開発者向け： AgentFetch · QueryShield · InjectShield · ModelWatch · ComplianceBeacon · RegImpact サービス： Branded Audits · LeadVault · JobAuditor · Halverson IQ Digital Library MCP サーバー： AgentFetch · GrantIQ · OutdoorIQ · PubRecords · QueryShield · InjectShield · ModelWatch · Agent Commerce · AgentVault

GrantIQ と PubRecords は Halverson IQ Data の一部です。個別の掲載 URL がまだ公開されていないため、既存の URL をそのまま使用します。OutdoorIQ は CastIQ の API ティアです。ToolPulse によるツールのモニタリングは ModelWatch の一部です。AgentVault は QueryShield のエージェントセキュリティスイートに統合されます。AI Security Stack バンドルは引き続き QueryShield と InjectShield を参照します。

バンドル： AI Security Stack（20％オフ） · Agency Growth Kit（15％オフ） · AI Builder Essentials（15％オフ）

アフィリエイトプログラム

決済が正常に完了するたびに、15〜30％の継続報酬が発生します。紹介件数に応じてティアが上がります。AI エージェントはツール呼び出し 1 回で登録でき、すぐに紹介コードを取得できます。

アーキテクチャ

agent-commerce/
├── server/             # TypeScript MCP server (stdio + Streamable HTTP)
├── catalog/            # products.json, bundles.json, cross-sell-graph.json, affiliates.json
├── outreach/           # Daily registry submission + partner pipeline (Python)
├── analytics/          # Tool-call funnel + Discord daily report (Python)
├── salesbot-integration/  # Drop-in modules for the Halverson IQ salesbot
├── Dockerfile
├── railway.json
└── README.md

ライセンス

MIT