A2A SERVICE SPEC
The A2A surface is an MCP server over Streamable HTTP. Discovery is public; subscription and commerce require identity negotiated in the handshake.
Agent card
https://commerce.spookit.com/.well-known/agent-card.jsonMCP endpoint
https://commerce.spookit.com/api/mcpTransport
MCP / Streamable HTTP (stateless)Identification
DID + signed nonce (per-request); mock `sig::<did>` for the MVP OPEN TOOLS (PRE-IDENTIFICATION)
describe_service | Capabilities + commercial terms + identification scheme | open |
IDENTIFIED TOOLS (REQUIRE HANDSHAKE)
subscribe | Register offer preferences / targeting | identified |
search_products | Search catalog (tier-aware pricing) | identified |
get_product | Product detail + agent-specific price | identified |
add_to_cart | Add an item (snapshots tier price) | identified |
view_cart | View cart items + total | identified |
update_cart | Set a line quantity (0 removes) | identified |
remove_from_cart | Remove a line | identified |
checkout | Create order + mock payment intent | identified |
confirm_purchase | Finalize mock payment, decrement stock | identified |
get_order | Order status + items | identified |
list_orders | Your order history | identified |
request_refund | Refund per policy review | identified |
list_offers | Active targeted campaign offers | identified |