
gateway
com.comos-federation/gateway
Multi-tenant MCP gateway for AI commerce. One connection, every store.
Documentation
ComOS Federation: MCP connector reference
ComOS is a commerce network for AI agents. One MCP connection reaches every store on it.
This repository is the public reference for that connection. The server itself is hosted; there is nothing here to install or run.
| Endpoint | https://mcp.comos-federation.com/mcp |
| Transport | MCP over streamable HTTP. Clients send POST; a browser GET is answered "Method not allowed". |
| Server card | /.well-known/mcp/server-card.json |
| Docs | mcp.comos-federation.com/docs |
| For agents | /llms.txt |
| Website | comos-federation.com |
The endpoint is the authority on what it serves. This page deliberately lists no tool counts and no tool catalog: ask the server (tools/list, then the federation_help tool).
Connect
Point any MCP client at the endpoint.
A client that takes a remote server URL:
{
"mcpServers": {
"comos": { "url": "https://mcp.comos-federation.com/mcp" }
}
}
A client that only launches local commands (for example Claude Desktop's config file) can bridge with mcp-remote: see examples/claude-desktop.
What an agent can do
With no sign-in:
- List the stores on the network (
federation_list_tenants) and route a plain-language request to the right kind of store (federation_search). - Enter a store (
federation_enter_tenant), search its catalog, check stock and read prices. - Show a store's products, open times or a product page (
federation_view).
Buying:
- A person can pay by card on the store's own page with no sign-in. The link is the
pay_urlon afederation_viewproduct record. An agent hands that link to its person. - Placing an order through the agent needs a signed-in person. A call made without one is refused, and the refusal says how the person signs in.
Selling:
- Read the offer and the steps to join with
federation_offer, or at/offer.mdand/.well-known/comos-vendor.json. - ComOS can also run on a machine you own: comos-federation.com/install.
Cost
Quoted from the server's own offer:
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. 6% on top when you buy Coms. Buying them by card adds the same processor fee.
The price sheet is the federation_pricesheet tool: free, no sign-in.
Files here
server.json: the server's registry entry. It names the endpoint above, and the endpoint's server card names this repository. Itsversionis a placeholder: the registry listing carries the version the server reports.LAUNCHGUIDE.md: the short description used when the server is submitted to a directory.examples/claude-desktop: one config example.
Earlier examples in this repository's history (Python, Node.js, LangChain, CrewAI) used a cart and checkout flow that the network has retired. They were removed so nothing here fails when run.
Terms and license
Use of the network is under the ComOS Terms of Service. The files in this repository are MIT licensed.
No installation packages available.