Repository avatar
AI Tools
v1.0.166
active

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.

Endpointhttps://mcp.comos-federation.com/mcp
TransportMCP over streamable HTTP. Clients send POST; a browser GET is answered "Method not allowed".
Server card/.well-known/mcp/server-card.json
Docsmcp.comos-federation.com/docs
For agents/llms.txt
Websitecomos-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_url on a federation_view product 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:

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. Its version is 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.