acp-sandbox
Agentic Commerce Protocol sandbox: agent builds a cart, human approves a real PayPal payment.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"acp-sandbox": {
"url": "https://acp-sandbox.flo-voice1.com/mcp"
}
}
}Puntos de conexión remotos
https://acp-sandbox.flo-voice1.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (8)
🟢list_products
List everything the demo store sells, with product ids and prices. Prices are in USD.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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).
Esquema de entrada
{
"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.
Esquema de entrada
{
"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#"
}Comunidad
Evidencia