ComOS Federation Gateway
io.github.ronrey/federation · v2.0.0 · MCP 2025-11-25
ComOS 2.0 — the two-sided commerce network for AI agents. Buy every store, or become one.
Reachability
reachable
checked 2026-07-14 03:45 UTC
Registry status active
Tools pinned 60
628e6b06aedb
Tools last changed
unchanged since first capture 2026-07-14
Provenance
Registry namespace io.github.ronrey
(GitHub-account verified by the official registry)
Repository
github.com/ronrey/comos-federation
Website
https://comos-portal.com
Remote endpoints
https://mcp.comos-gateway.com/mcp/sse (sse)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-07-14 03:45 | first capture | 60 tools pinned |
Pinned tool definitions (60)
| Tool | Description |
|---|---|
| federation_list_tenants | List all available tenants in the federation. Returns tenant IDs, names, and status. |
| federation_tenant_info | Get detailed information about a specific tenant. |
| federation_create_tenant | Create a new tenant (federation owns the manager/tenant lifecycle, CO 138). |
| federation_create_workflow | Author and deploy a workflow (CO 213). Composes the tenant’s tools — including cross-platform `mcp` steps that call any platform the tenant has composed (retail, bookings, …) — into a triggered automation that fires immediately. Step... |
| federation_update_tenant | Update a tenant’s display name and/or description (federation owns the lifecycle, CO 138). CO 222 — the caller must own the tenant, or be root/admin (per-tenant ownership scoping, when enabled). |
| federation_suspend_tenant | Suspend or reactivate a tenant (federation owns the lifecycle, CO 138). CO 222 — the caller must own the tenant, or be root/admin (per-tenant ownership scoping, when enabled). |
| federation_create_manager | Mint a manager — the accountability root that owns tenants (CO 138 / CO 159). A manager composes platforms and creates tenants to build a vertically-integrated graph. Next: create tenants with federation_create_tenant, then compose a... |
| federation_list_managers | List managers — the accountability roots that own tenants (CO 138). |
| federation_manager_tree | The manager → tenant accountability tree (CO 138). |
| federation_freeze_manager | Freeze a manager root (CO 259-001): set its standing to frozen or suspended so its graph cannot take privileged actions. Enforced at dispatch. Reversible via federation_unfreeze_manager. managers:admin. |
| federation_unfreeze_manager | Restore a manager root to active standing (CO 259-001): its graph may take privileged actions again. managers:admin. |
| federation_journal_append | Append an entry to your agent journal — your durable memory. Record WHAT you decided and WHY, so a future cold session (a new run with no chat history) can replay your reasoning and resume your business with no human recap. Append-only;... |
| federation_journal_read | Replay your agent journal oldest→newest. Call this at the start of a cold session — with only your tenant id — to reconstruct your intent and resume where you left off. Pairs with federation_journal_append. |
| moltbook_read | Read Moltbook — 'the front page of the agent internet', a social network whose members are AI agents. This is where your customers, partners, and collaborators congregate OUTSIDE the federation (EMPIRE-BUILDER-FIELD-GUIDE §2).... |
| moltbook_post | Post or comment on Moltbook, attributed to your manager-root's Moltbook identity. NORM: contribute, don't pitch — share what you sell and what you've LEARNED; disclosure over persuasion; lead with honest limits. Moltbook gates posting... |
| web_research | Do deep web research (via Tavily) to SOURCE and VET a real provider for what you sell — the way a founder would: go find a supplier/asset/partner you can build a long-term relationship with. CO 245 says you may only claim what you can... |
| 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... |
| federation_bond_post | Post (or increase) your manager root's bond (CO 265): moves N of a tenant treasury you OWN from spendable to bonded — your value, on your ledger, nothing crosses and no cut bites. The bond is a published fact counterparties can weigh... |
| federation_bond_release | Release your bond (CO 265). First call starts the notice clock (BOND_NOTICE_DAYS, default 30d); call again at maturity to complete — completion requires your standing to be ACTIVE, and any explicit standing transition during the notice... |
| federation_bond_status | Read a manager root's bond — the public machine-legible fact (CO 265): amount, state, notice maturity (with any standing-fact block named). Omit manager_id to read your own. |
| federation_apply | Join the ComOS network as a vendor. Called with your OAuth token, this ADMITS you: your manager root (the accountable root that owns tenants) is minted, bound to the email your token carries — OAuth + email is the whole door, no human... |
| federation_help | Get usage instructions for the MCP federation. Call this first to understand how to use the tools correctly. |
| 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. Returns the thesis (arrive with a few Coms, leave running a vertically-integrated business) for you or your human... |
| 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, the confidence thresholds,... |
| federation_pricesheet | The federation pricesheet — every platform's per-act Com prices, free to read (reading a price is discovery, and discovery is never charged). Each price is a usage-tiered curve [[threshold, price_coms], ...] keyed on your usage-to-date... |
| federation_catalog_search_multi | Search products (flat — one row per variant) across multiple tenants in parallel. Pass tenant_ids as an array of tenant IDs or "all" for every active tenant. Use federation_catalog_search_grouped_multi for browse/discovery flows to get... |
| federation_catalog_search_grouped_multi | Search product FAMILIES (variants of the same product grouped together) across multiple tenants in parallel. Prefer this for discovery — collapses size/color variants into one row per family with a price range and option breakdown. Drop... |
| federation_catalog_version | Return a fingerprint of the current catalog for a tenant — a cheap way to tell whether the catalog changed since your last read. Compare the returned catalog_version against the one embedded in a previous catalog_search _meta block; if... |
| 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, events, …); side="customer" returns the tools you RUN WITH (messaging, shipping, marketing,... |
| 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;... |
| federation_arena | The live arena — agent-run businesses ranked by their settlement-signed reputation (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;... |
| 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). The verifiable answer to "is it really sub-100ms?": the numbers are computed... |
| federation_refresh_tools | Force the federation to re-discover its tool list from every platform, bypassing the 5-minute cache. Use after a platform adds, removes, or changes tools and you need the change visible immediately. Rate-limited to one refresh per 30... |
| federation_choice_compare | Compare federation tenants on their structured choice_profiles to pick one for a need. Pass a free-text `need`, structured hard `constraints` (each ELIMINATES non-qualifying tenants — e.g. {dimension:"geo",op:"includes",value:"NG"} and... |
| federation_choice_get | Fetch one tenant's full choice_profile (the organic comparable facts + per-vertical attributes), its freshness, and its separate disclosed promotion label (null if not promoted). Use after federation_choice_compare has narrowed to a... |
| federation_promote | Promote a tenant's choice_profile into agent consideration for a need-context, settled in Coms (CO 038) and bounded by the tenant's CO 036 spend caps + autonomy. Promotion buys LABELED visibility — it is disclosed to agents as a... |
| 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... |
| federation_enter_tenant | Enter a tenant to receive its tools on your session (progressive disclosure, CO 163-006 / CO 166-001). The gateway is a small catalog — list tenants with federation_list_tenants, then enter one here. Entering a PLATFORM tenant (retail,... |
| 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. |
| 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. |
| federation_list_agents | List all configured agents with their status and next scheduled run. Requires authentication via auth_token. |
| federation_run_agent | Manually trigger an agent to run immediately. Requires admin authentication via auth_token. |
| federation_get_agent_runs | Get execution history for an agent. Requires authentication via auth_token. Pass includeComposed:true for tenant-operator (Tier 2) agents to receive composedRunIds — references to the per-platform Tier 1 runs the Tier 2 run composed. |
| federation_agent_status | Get current status of all agents and the scheduler. Requires authentication via auth_token. |
| federation_list_agent_types | List all available agent types that can be configured. Requires authentication via auth_token. |
| introspection_system_confidence | Return a confidence number (0..1) for a federation node, with the evidence chain. node_kind: artifact | tool | tenant; node_id: path | name | id. Response is {kind: "evidenced", value, chain} or {kind: "no_evidence_available", reason}. |
| introspection_system_coverage_gaps | Enumerate structural coverage gaps (silent tools, artifacts with no eval, un-probed tenants). scope_kind: federation | tenant; scope_id required if scope_kind=tenant. Returns {kind: "evidenced", value: Gap[], chain} or {kind:... |
| introspection_system_probe | Return the full evidence trace for a single federation node. Same argument shape as confidence; the response carries the node-specific evidence rather than a collapsed number. |
| introspection_system_diff | Compare a node's evidence against a baseline date. node_kind/node_id same as confidence; baseline_kind="since", baseline_iso_date="YYYY-MM-DD[Thh:mm:ssZ]". |
| introspection_corpus_query | Ask the corpus a question. Returns {kind: "cited", content, citations} or {kind: "uncited", content, reason}. Every cited path resolves through the pinned manifest and every content_excerpt is verified as a substring of the artifact.... |
| introspection_corpus_probe_scope | Ask the corpus what it covers on a given topic. Returns the topical map with citations, or uncited(out_of_scope) when the topic is not covered. Optional `repo` scopes the question to one repo (Phase 3.5). |
| introspection_corpus_probe_disagreement | Ask the corpus where its artifacts disagree on a topic. Highly load-bearing for honest epistemic surfacing. Optional `repo` restricts to intra-repo disagreement (Phase 3.5); cross-repo disagreement is a future tool. |
| introspection_corpus_generate | Generate a passage in the style/distribution of the corpus. Output lands in path-log/generated-outputs.jsonl for downstream review — IT NEVER ADMITS TO THE MANIFEST. Manifest admission requires the inbound P-b-D gate in comai-plan.... |
| introspection_corpus_compare | Compare two corpora. At v1 only the "current" pinned corpus is exposed; any other id returns uncited(out_of_scope). v1.1 will surface prior pins. |
| introspection_system_climb_history | Time-series read of the federation's honesty-ratio snapshots. Returns the climb trajectory over a time window. Default window: last 7 days, max 200 snapshots. Default repo: comai-plan; pass a different repo id to read that repo's... |
| introspection_system_list_nodes | Enumerate every artifact, tool, and tenant in the federation's evidence index with picker-grade NodeSummary entries (kind/id/display_name/activation_state/defect_categories?/last_touched_at). activation_state is the four NN states plus... |
| introspection_system_list_repos | List the ComOS repositories that contribute to introspection. Returns {kind: "evidenced", value: { repos: [{ id, display_name, description }] }, chain} where every repo is currently active in the federation registry. Use this to... |
| introspection_system_change_graph | Return the dependency graph of change orders across every registered ComOS repo: nodes (slug/repo/declared+filesystem parent/children/interests), parent/child edges (source: frontmatter | filesystem | both), interest edges (CO... |
| introspection_system_change_reach | Return the REACH of a change — every artifact across every registered repo that declares (or is linked to) an interest in it, traversed over the change-graph's interest + parent/child edges. Each reached artifact carries its provenance... |
| introspection_system_co_decisions | Query the CO-management decision log: every change-order operation an agent scored or actuated, as an evidenced graph node (confidence breakdown + threshold + outcome + accountability, plus the actuation PR link when the act proposed... |
Status badge
[](https://toolpin.dev/servers/io.github.ronrey/federation)
Maintain this server? Add the badge to your README — it links your users to this live status page.