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#"
}커뮤니티
증거