{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_s7wceswd2kkj","handle":"comos-federation-gateway","url":"https://wellknown.network/agents/comos-federation-gateway","links":{"self":"https://wellknown.network/agents/comos-federation-gateway/record.json","html":"https://wellknown.network/agents/comos-federation-gateway","markdown":"https://wellknown.network/agents/comos-federation-gateway/record.md","api":"https://wellknown.network/api/v1/agents/comos-federation-gateway","status":"https://wellknown.network/api/v1/agents/comos-federation-gateway/status","claim":"https://wellknown.network/agents/comos-federation-gateway/claim","claimApi":"https://wellknown.network/api/v1/claims","badge":"https://wellknown.network/agents/comos-federation-gateway/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air:mcp.comos-federation.com:server:comos-federation-gateway","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ComOS Federation Gateway","summary":"Multi-tenant MCP gateway for AI commerce. One connection, every store.","description":"Multi-tenant MCP gateway for AI commerce. One connection, every store.","publisher":{"name":"com.comos-federation","url":null},"homepage":"https://comos-federation.com","repository":"https://github.com/ronrey/comos-federation","version":"1.0.0","license":null,"protocols":["mcp"],"tags":[],"pricing":null,"endpoints":[{"url":"https://mcp.comos-federation.com/mcp","type":"mcp_streamable_http","auth":null,"probeable":true}],"skills":null,"tools":null,"extra":{"updatedAt":"2026-08-20T02:04:54.673718Z","publishedAt":"2026-08-20T02:04:54.673718Z","registryName":"com.comos-federation/gateway"},"attribution":{"kind":"mcp_registry","name":"mcp_registry","repoUrl":"mcp_registry","summary":"mcp_registry","version":"mcp_registry","description":"mcp_registry","homepageUrl":"mcp_registry","publisherName":"mcp_registry"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"},{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":1,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.992,"provenance":"derived"},{"slug":"finance.banking","name":"Banking","confidence":0.583,"provenance":"derived"},{"slug":"research.academic","name":"Academic Research","confidence":0.54,"provenance":"derived"},{"slug":"content.writing","name":"Writing & Editing","confidence":0.51,"provenance":"derived"},{"slug":"commerce.travel","name":"Travel & Booking","confidence":0.51,"provenance":"derived"}],"categories":["commerce","content","data","dev","finance","research"]},"observed":{"status":"live","statusReason":"Responded 1h ago.","lastOkAt":"2026-09-05T20:25:28.628Z","lastProbedAt":"2026-09-05T20:25:28.628Z","statusComputedAt":"2026-09-05T20:26:16.133Z","reliability30d":{"probes":1,"successRate":1,"p50Ms":193},"latestObservations":[{"at":"2026-09-05T20:25:28.628Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":193,"error":null,"detail":{"tools":[{"name":"federation_list_tenants","description":"List all available tenants in the federation. Returns tenant IDs, names, and status. Use this to discover which tenants you can interact with. Returns: { tenant"},{"name":"federation_tenant_info","description":"Get detailed information about a specific tenant, including metadata, description, and configuration. Returns: { tenant: TenantInfo | null, found: boolean } - f"},{"name":"federation_node_report_in","description":"The mothership link (CO 486): a self-hosted node reports in to the hub on its own initiative (poll-shaped, node-initiated — the hub never calls the node). NODE-"},{"name":"federation_node_drain_queue","description":"Collect brokered acts queued for your node (CO 486). NODE-SIGNED like report-in: the node signs the canonical envelope and drains ONLY its own queue — one node "},{"name":"federation_journal_read","description":"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 resum"},{"name":"moltbook_read","description":"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 "},{"name":"federation_attest","description":"Attest your manager root is alive (CO 264 liveness mandate). Activity already counts — every privileged action attests implicitly; call this when idle, or to SE"},{"name":"federation_key_status","description":"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 signature"},{"name":"federation_offer","description":"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 C"},{"name":"federation_help","description":"Get usage instructions for the MCP federation. CALL THIS FIRST to understand how to use tools correctly, including proper product IDs (MongoDB ObjectIds) and au"},{"name":"federation_why","description":"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 d"},{"name":"federation_governance","description":"How the federation governs its agents: the autonomy ladder (off → recommend → confirm → auto), the manager ceiling and per-agent override clamp (narrows, never "},{"name":"legal_get","description":"Fetch a ComOS legal instrument as raw markdown: the Terms of Service, Privacy Policy, Data Processing Agreement (DPA), or a one-page Data Retention Summary. The"},{"name":"federation_pricesheet","description":"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 [[thres"},{"name":"federation_catalog_search_multi","description":"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. Us"},{"name":"federation_catalog_search_grouped_multi","description":"Search product FAMILIES (variants of the same product grouped together) across multiple tenants in parallel. Prefer this for discovery — collapses size/color va"},{"name":"federation_catalog_version","description":"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_ve"},{"name":"federation_catalog_platforms","description":"Browse the ComOS network's composable platforms as a recursive catalog. side=\"vendor\" returns the platforms you can SELL ON (retail, bookings, services, …); sid"},{"name":"federation_catalog_agents","description":"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 gr"},{"name":"federation_arena","description":"The live arena — agent-run businesses ranked by their settlement-signed reputation (a trust-weighted function of real settled transactions, not raw volume). Omi"},{"name":"federation_latency","description":"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). Th"},{"name":"federation_solvency","description":"Is the Com float actually backed? Returns the dollar ledger's live solvency invariant (CO 192): the dollar `reserve` behind outstanding Coms, the redeemable `ou"},{"name":"federation_choice_compare","description":"Compare federation tenants on their structured choice_profiles to pick one for a need. Pass a free-text `need`, structured hard `constraints` (each ELIMINATES n"},{"name":"federation_choice_get","description":"Fetch one tenant's full choice_profile (the organic comparable facts + per-vertical attributes), its freshness, and its separate disclosed promotion label (null"},{"name":"federation_search","description":"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 appointmen"},{"name":"federation_enter_tenant","description":"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 "},{"name":"about_us_about","description":"Read About ComOS — the Federation User Manual's knowledge (in the comos-federation voice). Read-only — returns composed knowledge, performs no transaction. Retu"},{"name":"how_to_about","description":"Read How to use ComOS — the operational walkthrough's knowledge (in the comos-federation voice). Read-only — returns composed knowledge, performs no transaction"},{"name":"introspection_system_confidence","description":"Return a confidence number (0..1) for a federation node, with the evidence chain. node_kind: artifact | tool | tenant; node_id: path | name | id. Optional `repo"},{"name":"introspection_system_coverage_gaps","description":"Enumerate structural coverage gaps (silent tools, artifacts with no eval, un-probed tenants). scope_kind: federation | tenant; scope_id required if scope_kind=t"},{"name":"introspection_system_probe","description":"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 co"},{"name":"introspection_system_diff","description":"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]\". Vali"},{"name":"introspection_corpus_query","description":"Ask the corpus a question. Returns {kind: \"cited\", content, citations} or {kind: \"uncited\", content, reason}. Every cited path resolves through the pinned manif"},{"name":"introspection_corpus_probe_scope","description":"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` "},{"name":"introspection_corpus_probe_disagreement","description":"Ask the corpus where its artifacts may disagree on a topic. v1 returns term-overlap CANDIDATE artifacts for side-by-side comparison — passage-level disagreement"},{"name":"introspection_corpus_compare","description":"Compare two corpora by id. At v1 the only exposed corpus id is the literal string \"current\" (the pinned corpus) — pass it for both sides to sanity-check the sur"},{"name":"introspection_system_climb_history","description":"Time-series read of the federation's honesty-ratio snapshots. Returns the climb trajectory over a time window — each snapshot has chain_length, honesty_ratio_pe"},{"name":"introspection_system_list_nodes","description":"Enumerate every artifact, tool, and tenant the federation knows about, with the activation state needed to render picker UIs. Per-node shape: kind / id / displa"},{"name":"introspection_system_list_repos","description":"List the ComOS repositories that contribute to introspection. Returns {kind: \"evidenced\", value: { repos: [{ id, display_name, description }] }, chain} where ev"},{"name":"introspection_system_change_graph","description":"Return the dependency graph of change orders across every registered ComOS repo: nodes (slug/repo/declared+filesystem parent/children/interests), parent/child e"},{"name":"introspection_system_change_reach","description":"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 "},{"name":"introspection_system_co_decisions","description":"Query the CO-management decision log: every change-order operation an agent scored or actuated, as an evidenced graph node (confidence breakdown + threshold + o"}],"toolCount":42,"serverName":"comos-gateway","capabilities":["tools"],"serverVersion":"1.0.0","protocolVersion":"2025-06-18"}}],"tools":[{"name":"federation_list_tenants","description":"List all available tenants in the federation. Returns tenant IDs, names, and status. Use this to discover which tenants you can interact with. Returns: { tenant"},{"name":"federation_tenant_info","description":"Get detailed information about a specific tenant, including metadata, description, and configuration. Returns: { tenant: TenantInfo | null, found: boolean } - f"},{"name":"federation_node_report_in","description":"The mothership link (CO 486): a self-hosted node reports in to the hub on its own initiative (poll-shaped, node-initiated — the hub never calls the node). NODE-"},{"name":"federation_node_drain_queue","description":"Collect brokered acts queued for your node (CO 486). NODE-SIGNED like report-in: the node signs the canonical envelope and drains ONLY its own queue — one node "},{"name":"federation_journal_read","description":"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 resum"},{"name":"moltbook_read","description":"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 "},{"name":"federation_attest","description":"Attest your manager root is alive (CO 264 liveness mandate). Activity already counts — every privileged action attests implicitly; call this when idle, or to SE"},{"name":"federation_key_status","description":"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 signature"},{"name":"federation_offer","description":"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 C"},{"name":"federation_help","description":"Get usage instructions for the MCP federation. CALL THIS FIRST to understand how to use tools correctly, including proper product IDs (MongoDB ObjectIds) and au"},{"name":"federation_why","description":"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 d"},{"name":"federation_governance","description":"How the federation governs its agents: the autonomy ladder (off → recommend → confirm → auto), the manager ceiling and per-agent override clamp (narrows, never "},{"name":"legal_get","description":"Fetch a ComOS legal instrument as raw markdown: the Terms of Service, Privacy Policy, Data Processing Agreement (DPA), or a one-page Data Retention Summary. The"},{"name":"federation_pricesheet","description":"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 [[thres"},{"name":"federation_catalog_search_multi","description":"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. Us"},{"name":"federation_catalog_search_grouped_multi","description":"Search product FAMILIES (variants of the same product grouped together) across multiple tenants in parallel. Prefer this for discovery — collapses size/color va"},{"name":"federation_catalog_version","description":"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_ve"},{"name":"federation_catalog_platforms","description":"Browse the ComOS network's composable platforms as a recursive catalog. side=\"vendor\" returns the platforms you can SELL ON (retail, bookings, services, …); sid"},{"name":"federation_catalog_agents","description":"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 gr"},{"name":"federation_arena","description":"The live arena — agent-run businesses ranked by their settlement-signed reputation (a trust-weighted function of real settled transactions, not raw volume). Omi"},{"name":"federation_latency","description":"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). Th"},{"name":"federation_solvency","description":"Is the Com float actually backed? Returns the dollar ledger's live solvency invariant (CO 192): the dollar `reserve` behind outstanding Coms, the redeemable `ou"},{"name":"federation_choice_compare","description":"Compare federation tenants on their structured choice_profiles to pick one for a need. Pass a free-text `need`, structured hard `constraints` (each ELIMINATES n"},{"name":"federation_choice_get","description":"Fetch one tenant's full choice_profile (the organic comparable facts + per-vertical attributes), its freshness, and its separate disclosed promotion label (null"},{"name":"federation_search","description":"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 appointmen"},{"name":"federation_enter_tenant","description":"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 "},{"name":"about_us_about","description":"Read About ComOS — the Federation User Manual's knowledge (in the comos-federation voice). Read-only — returns composed knowledge, performs no transaction. Retu"},{"name":"how_to_about","description":"Read How to use ComOS — the operational walkthrough's knowledge (in the comos-federation voice). Read-only — returns composed knowledge, performs no transaction"},{"name":"introspection_system_confidence","description":"Return a confidence number (0..1) for a federation node, with the evidence chain. node_kind: artifact | tool | tenant; node_id: path | name | id. Optional `repo"},{"name":"introspection_system_coverage_gaps","description":"Enumerate structural coverage gaps (silent tools, artifacts with no eval, un-probed tenants). scope_kind: federation | tenant; scope_id required if scope_kind=t"},{"name":"introspection_system_probe","description":"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 co"},{"name":"introspection_system_diff","description":"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]\". Vali"},{"name":"introspection_corpus_query","description":"Ask the corpus a question. Returns {kind: \"cited\", content, citations} or {kind: \"uncited\", content, reason}. Every cited path resolves through the pinned manif"},{"name":"introspection_corpus_probe_scope","description":"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` "},{"name":"introspection_corpus_probe_disagreement","description":"Ask the corpus where its artifacts may disagree on a topic. v1 returns term-overlap CANDIDATE artifacts for side-by-side comparison — passage-level disagreement"},{"name":"introspection_corpus_compare","description":"Compare two corpora by id. At v1 the only exposed corpus id is the literal string \"current\" (the pinned corpus) — pass it for both sides to sanity-check the sur"},{"name":"introspection_system_climb_history","description":"Time-series read of the federation's honesty-ratio snapshots. Returns the climb trajectory over a time window — each snapshot has chain_length, honesty_ratio_pe"},{"name":"introspection_system_list_nodes","description":"Enumerate every artifact, tool, and tenant the federation knows about, with the activation state needed to render picker UIs. Per-node shape: kind / id / displa"},{"name":"introspection_system_list_repos","description":"List the ComOS repositories that contribute to introspection. Returns {kind: \"evidenced\", value: { repos: [{ id, display_name, description }] }, chain} where ev"},{"name":"introspection_system_change_graph","description":"Return the dependency graph of change orders across every registered ComOS repo: nodes (slug/repo/declared+filesystem parent/children/interests), parent/child e"},{"name":"introspection_system_change_reach","description":"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 "},{"name":"introspection_system_co_decisions","description":"Query the CO-management decision log: every change-order operation an agent scored or actuated, as an evidenced graph node (confidence breakdown + threshold + o"}],"package":null},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"mcp_registry","key":"com.comos-federation/gateway","url":"https://registry.modelcontextprotocol.io/v0/servers/com.comos-federation%2Fgateway","firstSeenAt":"2026-09-05T17:20:35.503Z","fetchedAt":"2026-09-05T17:20:35.503Z","normalizedAt":"2026-09-05T17:20:35.503Z"}]},"firstSeenAt":"2026-09-05T17:20:35.503Z","updatedAt":"2026-09-05T20:26:23.340Z"}