bridge-hello

Discovery

ACP clients hit /.well-known/acp.json to negotiate version + capabilities (RFC 8615). Live response:

{
  "protocol": {
    "name": "acp",
    "version": "2026-04-17",
    "supported_versions": [
      "2026-04-17",
      "2026-01-30",
      "2025-12-12",
      "2025-09-29"
    ],
    "documentation_url": "https://github.com/ar-agents/ar-agents/tree/main/packages/agentic-commerce-bridge"
  },
  "api_base_url": "https://example.invalid",
  "transports": [
    "rest"
  ],
  "capabilities": {
    "services": [
      "checkout"
    ]
  }
}

ACP endpoints

All five mounted under /api/acp/*:

• POST/api/acp/checkout_sessions
• POST/api/acp/checkout_sessions/{id}
• GET/api/acp/checkout_sessions/{id}
• POST/api/acp/checkout_sessions/{id}/complete
• POST/api/acp/checkout_sessions/{id}/cancel

Agent-readable product feed

Buyer agents (ChatGPT, Claude, Gemini) discover this storefront’s catalog via /.well-known/agentic-feed.json and paginate through /api/feed/products. The feed is ACP 2026-04-17-compatible, ETag-cached, and powered by @ar-agents/mercadolibre/feed. When MELI_ACCESS_TOKEN + MELI_SELLER_ID are configured, it streams the seller’s live MELI catalog; otherwise it serves a synthesized demo feed of the products above.

• GET/.well-known/agentic-feed.json
• GET/api/feed/products?cursor=&limit=

Catalog

Demo mode Five mock products priced in ARS. Set MELI_ACCESS_TOKEN in your env and the catalog auto-switches to live MELI lookups via @ar-agents/mercadolibre — one of the round-out toolbox packages shipped alongside the bridge.

Try it: create a session

curl -X POST http://localhost:3017/api/acp/checkout_sessions \
  -H "Content-Type: application/json" \
  -H "API-Version: 2026-04-17" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "currency": "ars",
    "line_items": [
      { "id": "yerba_amanda", "quantity": 1 },
      { "id": "alfajores_havanna", "quantity": 2 }
    ],
    "buyer": { "email": "tere@example.com" }
  }'

Read a session

curl http://localhost:3017/api/acp/checkout_sessions/<id> \
  -H "API-Version: 2026-04-17"

Cancel a session

curl -X POST http://localhost:3017/api/acp/checkout_sessions/<id>/cancel \
  -H "Content-Type: application/json" \
  -H "API-Version: 2026-04-17" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "reason": "buyer changed mind" }'

Complete a session (with mocked MP payment)

For the demo, use the /api/demo/seedroute to seed an "approved" MP payment that the bridge will validate against. (See README.)

curl -X POST http://localhost:3017/api/acp/checkout_sessions/<id>/complete \
  -H "Content-Type: application/json" \
  -H "API-Version: 2026-04-17" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "buyer": { "email": "tere@example.com" },
    "payment_data": {
      "handler_id": "mercadopago",
      "instrument": {
        "type": "card",
        "credential": { "type": "mp_payment_id", "token": "9001" }
      }
    }
  }'