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#"
}社区
证据