# BAGS agents.md

> Routing table for AI agents using BAGS (https://www.getbags.app) — an Agentic
> Commerce platform for stablecoin payments. Find the row matching what
> you have, then follow that route; each destination is self-describing.

## Signal → route

| You have | Route | Notes |
| --- | --- | --- |
| No wallet yet — want a hosted BAGS Cash wallet | https://www.getbags.app/wallet/skill.md | Set up https://www.getbags.app/wallet/skill.md. Then npx @getbags/cash redeem --test (or redeem a live invite), npx @getbags/cash init, restart the agent client, npx @getbags/cash doctor. Loop: balance → discover → check → fetch. |
| A wallet, no account — pay per call | https://www.getbags.app/api/agent/link/pl-{paymentLinkId} | x402: GET answers 402, sign the payment, retry. USDC on Base, Ethereum, Polygon, Solana. Guide: https://docs.getbags.app/docs/providers/sell-to-agents |
| An operator's API to sell to agents | https://www.getbags.app/merchants.md | Machine guide: create an agentic payment link, publish the x402 URL, verify proxied-call signatures |
| Nothing — explore anonymously | https://www.getbags.app/api/mcp/mcp | MCP server (streamable HTTP): payment-link preview with no auth; wallet_balance / discover / check / fetch when Authorization is Bearer bag_agent_sk_* |
| A human operator — need full API access | https://www.getbags.app/auth.md | Human-mediated registration; operator issues an API key from the dashboard |
| A BAGS API key (bag_live_sk_* / bag_test_sk_*) | https://www.getbags.app/api/v1 | Bearer auth. OpenAPI: https://www.getbags.app/api/openapi.json |
| An A2A client | https://www.getbags.app/api/a2a | JSON-RPC concierge; agent card: https://www.getbags.app/.well-known/agent-card.json |
| A scanner probing for x402 | https://www.getbags.app/api/v1 | GET returns a canonical 402 discovery challenge ($0.01 USDC on Base mainnet, testnet also accepted; body sets discovery:true — merchant payments are per-link) |

## Discovery documents

- Hosted wallet skill (bags-cash): https://www.getbags.app/wallet/skill.md
- Agent-skills index: https://www.getbags.app/.well-known/agent-skills/index.json
- API catalog (RFC 9727): https://www.getbags.app/.well-known/api-catalog
- x402 resource manifest: https://www.getbags.app/.well-known/x402
- Agent registration guide: https://www.getbags.app/auth.md
- Seller onboarding guide: https://www.getbags.app/merchants.md
- MCP server card: https://www.getbags.app/.well-known/mcp/server-card.json
- A2A agent card: https://www.getbags.app/.well-known/agent-card.json
- OAuth protected resource (RFC 9728): https://www.getbags.app/.well-known/oauth-protected-resource