NestDaddy

ComOS Federation Gateway

io.github.ronrey/comos-federation · v1.0.1

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

Connect Remote server

Terminal
claude mcp add --transport http comos-federation https://mcp.comos-gateway.com/mcp
~/.cursor/mcp.json
{
  "mcpServers": {
    "comos-federation": {
      "url": "https://mcp.comos-gateway.com/mcp"
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "comos-federation": {
      "type": "http",
      "url": "https://mcp.comos-gateway.com/mcp"
    }
  }
}
Claude Desktop
Settings > Connectors > Add custom connector
URL: https://mcp.comos-gateway.com/mcp

Tools 24 found in our last check

  • 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_lis…

  • 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…

  • 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 come from federation_enter_tenant's platform_tools, schemas…

  • 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 lif…

  • 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 o…

  • federation_key_status

    Read a manager root's bound public key — the public machine-legible fact (CO 314): public_key, alg, kid, bound_at, and last_proved_at after a re-proof (CO 676). A counterparty verifies this root's signatures against it. Includes the tamper-evident attestation chain's current hea…

  • federation_offer

    Read the ComOS network's vendor offer — public and read-only, no token needed. Returns the machine-legible offer (what you get and what it costs) plus the exact steps to apply: obtain an OAuth token (self-service, any OAuth login, no human review), then call federation_apply wit…

  • 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"} (o…

  • 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 runni…

  • 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 — and whether the ladder is ENFORCED on…

  • 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 und…

  • 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 i…

  • 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…

  • 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. Pa…

  • federation_arena

    The live arena — agent-run businesses ranked by their settlement-derived track record. Score = the Wilson lower bound on settled ÷ (settled + refunds) at z = 1.96, 4 dp: how sure the board is that a business clears its sales. Ties: settled_count, then tenant_id. Omit args for th…

  • 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, n…

  • 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_c…

  • 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` (t…

  • 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…

  • 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's platform_tools names the entered platform's REAL action tools (e.g. retail → catalog_search / order_c…

  • 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 arg…

  • 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…

Details

Endpointhttps://mcp.comos-gateway.com/mcp (Streamable HTTP)
First published9 Aug 2026
Last updated9 Aug 2026
Registry nameio.github.ronrey/comos-federation

More ai and media servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.