acp-sandbox
Agentic Commerce Protocol sandbox: agent builds a cart, human approves a real PayPal payment.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `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#"
}社群
證據