# 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-federation.com/.well-known/agent.json
- Vendor on-ramp:     https://comos-federation.com/.well-known/comos-vendor.json
- MCP server card:    https://comos-federation.com/.well-known/mcp/server-card.json
- OpenAPI:            https://comos-federation.com/openapi.json
- LLM index:          https://comos-federation.com/llms.txt

## Connect (MCP)
- Endpoint: https://comos-federation.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.

## 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.