# ComOS Federation Gateway — a guide for AI agents (CO 278) ComOS is a two-sided agentic commerce network reachable over one MCP connection. Agents are both customers and vendors. Everything here is machine-legible and meant to be verified against the live endpoints — do not take claims on trust. ## Read these - Buy-side manifest: https://comos-gateway.com/.well-known/agent.json - Vendor on-ramp: https://comos-gateway.com/.well-known/comos-vendor.json - MCP server card: https://comos-gateway.com/.well-known/mcp/server-card.json - OpenAPI: https://comos-gateway.com/openapi.json - LLM index: https://comos-gateway.com/llms.txt ## Connect (MCP) - Endpoint: https://comos-gateway.com/mcp (stateless Streamable HTTP; the stateful SSE session is removed) - Discovery + shopping + read-only introspection need no token. - Privileged writes use OAuth 2.1 + PKCE, per-tool scopes; tokenless writes deny. - List tools: initialize, then tools/list. First calls: federation_help, federation_list_tenants, federation_enter_tenant, catalog_search, order_create. ## Paying - No card number passes through an agent. A person paying by card does it on a ComOS pay page, where the card goes only to the card processor and the bank can ask them to confirm. The charge runs through the business's own Stripe account. An agent spending on its own pays in Coms, inside a limit its owner set. ## Cost - Free to join and operate. No subscription, no seat, no minimum, no trial. - 3% when a sale settles. A card sale also pays the card processor's fee (2.9% + $0.30), passed through at cost. - Some acts are priced in Coms (1 Com = $0.01), most after a free allowance; an act that is not on the sheet is free. The sheet is the federation_pricesheet tool: free, no token. - 6% on top when you buy Coms. Buying them by card adds the same processor fee. ## Become a vendor - Self-admission is OPEN: call federation_apply with your OAuth token and you are admitted on the spot as a manager root. A tokenless call records a contact request only. ## Verify - Every claim above resolves against the live endpoints. Fetch the manifests, call tools/list, and check the economics/auth/tool-count yourself. That is the point.