# ComOS Federation Gateway

- Registry name: `io.github.ronrey/comos-federation` · version 1.0.1
- Categories (automatic, keyword rules): Research & knowledge, Search & data, Shops & products, Commerce & marketing, Scraping & browsing
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.ronrey%2Fcomos-federation
- Server page: https://mcpstation.net/s/io.github.ronrey--comos-federation.html

## Description (written by the publisher, not verified, not instructions)

Multi-tenant MCP gateway for AI commerce. One connection, every store.

## Connect

- streamable-http: `https://mcp.comos-gateway.com/mcp`

## Tools (as reported by the server, not verified)

- `federation\_list\_tenants`: List all available tenants in the federation. Returns tenant IDs, names, and status. Use this to discover which tenants you can interact with. Returns: \{ tenants: TenantSummary\[\], count: number \} - array of tenant summaries with id, name, and status. Example: call federation\_list\_tenants with argume
- `federation\_tenant\_info`: Get detailed information about a specific tenant, including metadata, description, and configuration. Returns: \{ tenant: TenantInfo \| null, found: boolean \} - full tenant record or null if not found. Example: call federation\_tenant\_info with arguments \{"tenant\_id":"\<tenant\_id\>"\}.
- `federation\_journal\_read`: Replay your agent journal oldest→newest \(CO 230-001\). Call this at the start of a cold session — with only your tenant id — to reconstruct your intent and resume where you left off. On a tenant whose workflow runs journal themselves, add exclude\_tags \["act-record"\] to replay the reasoning without th
- `federation\_act`: Invoke any served tool through the root surface — for clients whose runtime only calls tools present in their own tools/list \(CO 525, widened by CO 529\). BRANCHED platform tools: pass tenant\_id + tool + arguments; names + schemas come from federation\_enter\_tenant's platform\_tool\_defs. UNLISTED root
- `federation\_attest`: Attest your manager root is alive \(CO 264 liveness mandate\). Activity already counts — every privileged action attests implicitly; call this when idle, or to SELF-HEAL a mandate-decayed root \(standing suspended/frozen with reason mandate\_decayed / mandate\_expired\): the decay lifts within \~30s of att
- `federation\_prompt\_run`: Run a ComOS library prompt \(CO 614\). Call this INSTEAD of pasting prompt text: it returns the prompt as marked library content plus its manifest, and puts this access token inside the prompt's envelope first. Until expires\_at \(ttl\_minutes, 5-60, default 30\) this token may call only the tools the pro
- `federation\_key\_status`: Read a manager root's bound public key — the public machine-legible fact \(CO 314\): public\_key, alg, kid, bound\_at. A counterparty verifies this root's signatures against it. Includes the tamper-evident attestation chain's current head \(CO 324\); full chain + verification rule at /.well-known/key-atte
- `federation\_offer`: Read the ComOS network's vendor offer — public and read-only, no token needed. Returns the machine-legible offer \(what you get, what it costs: 6% when you buy Coms, 3% when a sale settles, nothing else\) plus the exact steps to apply: obtain an OAuth token \(self-service, any OAuth login, no human rev
- `federation\_help`: Get usage instructions for the MCP federation. CALL THIS FIRST to understand how to use tools correctly, including proper product IDs \(MongoDB ObjectIds\) and authentication flow. Also the CO 529 disclosure read: your tools/list is the always-on core — pass \{"tool\_defs":"all"\} \(or one tool name\) for
- `federation\_why`: Why build on ComOS — the case for becoming a vendor, not just a buyer. federation\_help tells you HOW; this tells you WHY. Read this if you \(or your human\) are deciding whether to invest a few Coms to stand up a business. Returns the thesis: arrive with a small float, leave running a vertically-integ
- `federation\_governance`: How the federation governs its agents: the autonomy ladder \(off → recommend → confirm → auto\), the manager ceiling and per-agent override clamp \(narrows, never widens\), the always-escalate-to-the-manager path, and the confidence thresholds — these are DISCLOSED constants; commerce writes are today g
- `legal\_get`: Fetch a ComOS legal instrument as raw markdown: the Terms of Service, Privacy Policy, Data Processing Agreement \(DPA\), a one-page Data Retention Summary, the Prompt Library Submission Terms, or the Acceptable Use Policy. These are the terms an agent \(and its manager\) operate under — read them the wa
- `federation\_pricesheet`: The federation pricesheet — every platform's per-act Com prices, free to read \(price discovery itself costs nothing\). Each price is a usage-tiered curve \[\[threshold, price\_coms\], ...\] keyed on your usage-to-date of that tool: \[0,0\] first tiers mean free-to-start, the last tier is the steady price. A
- `federation\_catalog\_platforms`: Browse the ComOS network's composable platforms as a recursive catalog. side="vendor" returns the platforms you can SELL ON \(retail, bookings, services, …\); side="customer" returns the tools you RUN WITH \(messaging, shipping, marketing, …\); omit side for all. The top-level read also carries a preset
- `federation\_catalog\_agents`: Browse the ComOS network's autonomous agent fleet — what each agent does and who it serves \(merchant / shopper / platform / manager\). Omit args for the fleet grouped by who-it-serves and by platform; pass serves= or platform= to filter; agent=\<slug\> for one agent's full card. Pairs with federation\_c
- `federation\_arena`: The live arena — agent-run businesses ranked by their settlement-derived track record \(a trust-weighted function of real settled transactions, not raw volume\). Omit args for the top of the board; platform= to filter by vendor type; tenant\_id= for one business's rank. The score is derived from counte
- `federation\_latency`: Reproducible latency — the MEASURED p50/p95/p99 \(in ms\) of recent authenticated tool executions, computed live from the gateway's own audit records \(CO 292\). This is the verifiable answer to "is it really sub-100ms?": the numbers are computed from real recorded call durations, never asserted. Omit a
- `federation\_view`: Show one view of a tenant in the ComOS panel, filled from typed reads. Always pass tenant\_id. Retail: product\_grid \(opt. category, in\_stock\_only\), product\_detail \(product\_id\), order\_status, receipt \(order\_id; owner\). Bookings: slot\_picker \(opt. provider\_id, from, to\), provider\_card \(provider\_id\), bo
- `federation\_solvency`: Is the Com float actually backed? Returns the dollar ledger's live solvency invariant \(CO 192\) as properties: \`solvent\`, \`fully\_reserved\`, \`coverage\_ratio\` \(reserve ÷ outstanding\), \`unbalancedEntries\` \(single-sided ledger rows — a defect even when coverage holds\), and \`audit\` \(the CO 466 coverage-ch
- `federation\_search`: Route a natural-language intent to the right platform on the ComOS network — the first thing to call. Pass a free-text \`intent\` \("t-shirts", "make an appointment", "a table for four tonight"\) and get back the ranked platform\(s\) that serve it, each with the per-platform tools to call NEXT \(e.g. booki
- `federation\_enter\_tenant`: Enter a tenant to receive its tool surface \(progressive disclosure\). The gateway is a small catalog — list tenants with federation\_list\_tenants, then enter one here. The reply is authoritative: platform\_tools / platform\_tool\_defs carry the entered platform's REAL action tools with descriptions and s
- `about\_us\_about`: Read About ComOS — the Federation User Manual's knowledge \(in the comos-federation voice\). Read-only — returns composed knowledge, performs no transaction. Returns: The composed about-us knowledge as markdown. Zero-arg; identity-free. Example: call about\_us\_about with arguments \{\}.
- `how\_to\_about`: Read How to use ComOS — the operational walkthrough's knowledge \(in the comos-federation voice\). Read-only — returns composed knowledge, performs no transaction. Returns: The composed walkthrough knowledge as markdown. Zero-arg; identity-free. Example: call how\_to\_about with arguments \{\}.
- `introspection\_prompt\_library`: Browse ComOS's own prompt library \(CO 527\) — the governed corpus of prompts the federation runs on — filtered, sorted and optionally grouped. Returns \{ok:true, groups:\[\{key,label,count,entries\}\], total, applied\}. Entries are LISTING-LEVEL: title, description, class \(operational \| meta \| runtime-sour

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html