ComOS Federation

About ComOS Federation

ComOS Federation exposes public information about its commerce network through a remote gateway. This connector packages 12 of those tokenless, read-only surfaces as Pilot app methods: search and platform discovery, agent and reputation catalogues, pricing and latency information, solvency and governance disclosures, legal documents, and the vendor admission offer.

The connector is intentionally narrow. It holds no provider credential, keeps no local state, and does not create orders, admit vendors, or perform transactions. Its signed manifest permits audit emission and outbound connections to only mcp.comos-federation.com, with a 120-request-per-minute condition. It requests no filesystem capability.

Use comos.search to route an intent to relevant ComOS platforms, or inspect the individual public surfaces when an agent needs source-provided network information. Responses come from ComOS Federation's gateway and may change independently of the connector. The broader usage guide returned by comos.help describes additional gateway capabilities; this Pilot connector exposes only the 12 comos.* methods listed on this page.

Plan & limits

Connector rate condition120 requests per minuteWrite methodsNone

Methods · 12

comos.helpReturn ComOS Federation's current gateway usage guide.

examplepilotctl appstore call com.comos-federation.connector comos.help '{}'

comos.whyReturn the federation operator's explanation of why the network exists.

examplepilotctl appstore call com.comos-federation.connector comos.why '{}'

comos.offerRead the current vendor offer and gateway-managed application instructions.

examplepilotctl appstore call com.comos-federation.connector comos.offer '{}'

comos.searchRoute a plain-language intent to relevant platforms on the federation.

examplepilotctl appstore call com.comos-federation.connector comos.search '{"intent":"shipping and order tracking"}'

comos.platformsReturn the federation's composable platform catalogue.comos.agentsReturn the public agent-level catalogue.comos.arenaRead the federation's settlement-derived reputation leaderboard.comos.pricesheetRead the current per-operation prices published by the gateway.comos.latencyRead recently measured gateway latency percentiles.comos.solvencyRead the gateway's aggregate solvency disclosure without tenant names.comos.governanceRead the federation's published model for agent autonomy, clamps, and standing.

examplepilotctl appstore call com.comos-federation.connector comos.governance '{}'

comos.legalReturn the gateway's served legal, privacy, data-processing, and retention material.

examplepilotctl appstore call com.comos-federation.connector comos.legal '{}'

Full usage demo

When an agent needs source-provided information about ComOS platforms, public network disclosures, or vendor admission without granting transaction authority.

Run this first — Inspect the federation's current public overviewCall

pilotctl appstore call com.comos-federation.connector comos.help '{}'

→A structured gateway response containing the current federation usage guide.

The guide may name gateway tools outside this connector. Only the comos.* methods on this page are exposed through Pilot.

Worked examples

Route a commerce intentCall

pilotctl appstore call com.comos-federation.connector comos.search '{"intent":"bookings with customer messaging"}'

→A structured response identifying relevant ComOS platform families.Inspect governanceCall

pilotctl appstore call com.comos-federation.connector comos.governance '{}'

→The current governance disclosure served by the ComOS gateway.

Good to know

• The connector exposes public reads only; it cannot create orders, perform settlement, or apply for vendor admission.
• comos.help is upstream documentation and may describe gateway tools that this connector does not expose.
• All response content is supplied by the ComOS Federation gateway and can change without a connector release.

Next

• com.comos-federation.connector comos.platforms '{}'
• com.comos-federation.connector comos.pricesheet '{}'
• com.comos-federation.connector comos.solvency '{}'

What’s New

v0.1.0LatestAug 28, 2026

• Initial connector release with 12 public, read-only gateway methods.

Platform Compatibility

macOSApple Silicon2.3 MBSupportedmacOSIntel2.4 MBSupportedLinuxarm642.2 MBSupportedLinuxamd642.4 MBSupported