acp-sandbox
Agentic Commerce Protocol sandbox: agent builds a cart, human approves a real PayPal payment.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"acp-sandbox": {
"url": "https://acp-sandbox.flo-voice1.com/mcp"
}
}
}リモートエンドポイント
https://acp-sandbox.flo-voice1.com/mcpstreamable-httpできること
ツール一覧
ツール（8）
🟢list_products
List everything the demo store sells, with product ids and prices. Prices are in USD.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_checkout(items, buyer_email, api_key)
Start a checkout (an Agentic Commerce Protocol checkout session) with the products and quantities the user wants. Returns the session id, the cart and its total. If you have no api_key yet, leave it out: a sandbox key is created and returned — reuse it in every later call.
入力スキーマ
{
"type": "object",
"properties": {
"items": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string"
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 99
}
},
"required": [
"product_id",
"quantity"
]
},
"description": "Products to buy, by product_id from list_products."
},
"buyer_email": {
"description": "The buyer's email, if the user gave one.",
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"api_key": {
"description": "Sandbox key from create_checkout (not needed if the connection already carries one).",
"type": "string"
}
},
"required": [
"items"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡update_checkout(session_id, items, api_key)
Replace the items in an open checkout (e.g. the user changed their mind). Any PayPal payment created for the old total is dropped — request a new one.
入力スキーマ
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"items": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string"
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 99
}
},
"required": [
"product_id",
"quantity"
]
}
},
"api_key": {
"description": "Sandbox key from create_checkout (not needed if the connection already carries one).",
"type": "string"
}
},
"required": [
"session_id",
"items"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_checkout(session_id, api_key)
Read the current cart, total, payment status and order of a checkout.
入力スキーマ
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"api_key": {
"description": "Sandbox key from create_checkout (not needed if the connection already carries one).",
"type": "string"
}
},
"required": [
"session_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡request_paypal_payment(session_id, api_key)
Create a PayPal (sandbox) payment for the checkout's exact total. Returns approve_url: give that link to the user and ask them to approve the payment on PayPal — you cannot approve it yourself. Then call wait_for_payment_approval.
入力スキーマ
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"api_key": {
"description": "Sandbox key from create_checkout (not needed if the connection already carries one).",
"type": "string"
}
},
"required": [
"session_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪wait_for_payment_approval(session_id, timeout_seconds, api_key)
Wait (up to 45s per call) until PayPal reports the user approved the payment. If it returns still_waiting, the user hasn't approved yet — ask them, then call again.
入力スキーマ
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"timeout_seconds": {
"default": 45,
"type": "integer",
"minimum": 1,
"maximum": 45
},
"api_key": {
"description": "Sandbox key from create_checkout (not needed if the connection already carries one).",
"type": "string"
}
},
"required": [
"session_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪complete_checkout(session_id, payment, api_key)
Place the order. With payment "paypal" the approved PayPal payment is captured first, and the order only goes through if PayPal confirms the money for the exact total. "mock" skips real payment (testing only).
入力スキーマ
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"payment": {
"default": "paypal",
"type": "string",
"enum": [
"paypal",
"mock"
]
},
"api_key": {
"description": "Sandbox key from create_checkout (not needed if the connection already carries one).",
"type": "string"
}
},
"required": [
"session_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴cancel_checkout(session_id, api_key)
Cancel an open checkout. Nothing is charged.
入力スキーマ
{
"type": "object",
"properties": {
"session_id": {
"type": "string"
},
"api_key": {
"description": "Sandbox key from create_checkout (not needed if the connection already carries one).",
"type": "string"
}
},
"required": [
"session_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}コミュニティ
エビデンス