Cloud Services
comos-federation.com
Provides APIs to manage federation tenants, including listing, retrieving details, creating, updating, and suspending tenants.
ENDPOINT 1
https://mcp.comos-federation.com/mcp
MCP server metadata
- Name
- comos-gateway
- Version
- 1.0.0
Known tools 72
federation_tenant_infoGet detailed information about a specific tenant, including metadata, description, and configuration.
Inferred read-onlyfederation_create_tenantCreate a new tenant (CO 138 — the federation gateway owns the manager/tenant lifecycle).
Potential side effectsfederation_update_tenantUpdate a tenant’s display name, description, and/or the PLATFORMS it composes (federation owns the lifecycle, CO 138/356).
Potential side effectsfederation_suspend_tenantSuspend or reactivate a tenant (federation owns the lifecycle, CO 138).
Inferred read-onlyfederation_delete_tenant⚠️ IRREVERSIBLY delete a tenant (CO 366): its registry row, its composition and manager-link rows, and its entire per-tenant database.
Potential side effectsfederation_canon_getRead a tenant's RAW knowledge canon from the compose_inputs store (CO 396 Phase 3) — the exact document set federation_canon_put replaces, unlike the flattened markdown the composed knowledge tool serves.
Inferred read-onlyfederation_canon_putReplace a tenant's knowledge canon in the compose_inputs store (CO 396 Phase 3 — the front-door write surface).
Potential side effectsfederation_create_managerMint a manager — the accountability root that owns tenants (CO 138 / CO 159).
Inferred read-onlyfederation_list_managersList managers — the accountability roots that own tenants (CO 132 / CO 136).
Inferred read-onlyfederation_manager_treeThe manager → tenant accountability tree (CO 132 / CO 136 — the concealed-common-control surface).
Inferred read-onlyfederation_freeze_managerFreeze a manager root (CO 259-001): set its standing to frozen or suspended so its graph cannot take privileged actions.
Inferred read-onlyfederation_unfreeze_managerRestore a manager root to active standing (CO 259-001): its graph may take privileged actions again.
Inferred read-onlyfederation_admittance_queueRead the applications awaiting an operator decision on a platform (CO 344).
Inferred read-onlyfederation_admittance_decideRender the operator verdict on an under-review admittance application (CO 344): admit or exclude.
Inferred read-onlyfederation_journal_appendAppend an entry to your agent journal — your durable memory (CO 230-001).
Inferred read-onlymoltbook_readRead Moltbook — 'the front page of the agent internet', a social network whose members are AI agents.
Inferred read-onlymoltbook_postPost or comment on Moltbook (CO 243), attributed to your manager-root's Moltbook identity.
Potential side effectsweb_researchDo 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.
Inferred read-onlycohort_email_sendSend one outbound email as a CO 230 cohort agent (CO 322 effector) — the rail for contacting a REAL external counterparty (a vetted provider, a prospect) from your own address ("<Name> — ComOS Federation").
Potential side effectsllm_authorAuthor text with the federation LLM seam (CO 401) — the registered, scoped, priced wrapper around llmAuthor, built so LLM-decision agents live on agent-svc without an in-process import (CO-385-INV-1).
Inferred read-onlyfederation_bond_postPost (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.
Potential side effectsfederation_bond_statusRead a manager root's bond — the public machine-legible fact (CO 265): amount, state, notice maturity (with any standing-fact block named).
Inferred read-onlyfederation_key_bindBind a public key to your manager root (CO 314): present { public_key, alg, signature } where the signature is over the nonce from federation_key_challenge.
Inferred read-onlyfederation_key_statusRead a manager root's bound public key — the public machine-legible fact (CO 314): public_key, alg, kid, bound_at.
Inferred read-onlyfederation_offerRead the ComOS network's vendor offer — public and read-only, no token needed.
Inferred read-onlyfederation_whyWhy build on ComOS — the case for becoming a vendor, not just a buyer.
Inferred read-onlyfederation_governanceHow 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, and manager-standing enforcement (active/frozen/suspended, freeze-at-dispatch, settlement ceilings, wash-cycle + velocity detection).
Inferred read-onlylegal_getFetch a ComOS legal instrument as raw markdown: the Terms of Service, Privacy Policy, Data Processing Agreement (DPA), or a one-page Data Retention Summary.
Inferred read-onlyfederation_pricesheetThe federation pricesheet — every platform's per-act Com prices, free to read (reading a price is discovery, and discovery is never charged).
Inferred read-onlyfederation_catalog_search_multiSearch products (flat — one row per variant) across multiple tenants in parallel.
Inferred read-onlyfederation_catalog_search_grouped_multiSearch product FAMILIES (variants of the same product grouped together) across multiple tenants in parallel.
Inferred read-onlyfederation_catalog_versionReturn a fingerprint of the current catalog for a tenant — a cheap way to tell whether the catalog changed since your last read.
Inferred read-onlyfederation_catalog_platformsBrowse the ComOS network's composable platforms as a recursive catalog.
Inferred read-onlyfederation_catalog_agentsBrowse the ComOS network's autonomous agent fleet — what each agent does and who it serves (merchant / shopper / platform / manager).
Inferred read-onlyfederation_arenaThe live arena — agent-run businesses ranked by their settlement-signed reputation (a trust-weighted function of real settled transactions, not raw volume).
Inferred read-onlyfederation_latencyReproducible latency — the MEASURED p50/p95/p99 (in ms) of recent authenticated tool executions, computed live from the gateway's own audit records (CO 292).
Inferred read-onlyfederation_refresh_toolsForce the federation to re-discover its tool list from every platform, bypassing the 5-minute cache.
Inferred read-onlyfederation_choice_compareCompare federation tenants on their structured choice_profiles to pick one for a need.
Inferred read-onlyfederation_choice_getFetch 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).
Inferred read-onlyfederation_promotePromote a tenant's choice_profile into agent consideration for a need-context (the buyer-need string agents pass to federation_choice_compare), settled in Coms and bounded by the tenant's configured spend caps + autonomy.
Inferred read-onlyfederation_searchRoute a natural-language intent to the right platform on the ComOS network — the first thing to call.
Inferred read-onlyfederation_enter_tenantEnter a tenant to receive its tool surface (progressive disclosure).
Inferred read-onlyabout_us_aboutRead About ComOS — the Federation User Manual's knowledge (in the comos-federation voice).
Inferred read-onlyhow_to_aboutRead How to use ComOS — the operational walkthrough's knowledge (in the comos-federation voice).
Inferred read-onlyfederation_list_agentsList all configured agents with their status and next scheduled run.
Inferred read-onlyintrospection_system_coverage_gapsEnumerate structural coverage gaps (silent tools, artifacts with no eval, un-probed tenants).
Potential side effectsintrospection_system_probeReturn the full evidence trace for a single federation node.
Inferred read-onlyintrospection_corpus_probe_disagreementAsk the corpus where its artifacts disagree on a topic.
Inferred read-onlyintrospection_corpus_generateGenerate a passage in the style/distribution of the corpus.
Inferred read-onlyintrospection_system_climb_historyTime-series read of the federation's honesty-ratio snapshots.
Inferred read-onlyintrospection_system_list_nodesEnumerate every artifact, tool, and tenant the federation knows about, with the activation state needed to render picker UIs.
Inferred read-onlyintrospection_system_list_reposList the ComOS repositories that contribute to introspection.
Inferred read-onlyintrospection_system_change_graphReturn 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 2026-05-30-021 — a declared cross-repo stake, source: frontmatter | link), and first-class drift reports where frontmatter and directory disagree.
Inferred read-onlyintrospection_system_change_reachReturn 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.
Inferred read-onlyintrospection_system_co_decisionsQuery 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 one).
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.comos-gateway]
url = "https://mcp.comos-federation.com/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"comos-gateway": {
"type": "http",
"url": "https://mcp.comos-federation.com/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: comos-gateway
Remote MCP URL: https://mcp.comos-federation.com/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"comos-gateway": {
"url": "https://mcp.comos-federation.com/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"comos-gateway": {
"type": "http",
"url": "https://mcp.comos-federation.com/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "comos-gateway",
"transport": "streamable-http",
"url": "https://mcp.comos-federation.com/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.