# ComOS Federation Gateway

ComOS Federation Gateway — an MCP server for Claude Code and Codex that links agents to the ComOS commerce network. Connects assistants to store catalogs, stock lookups, and checkout flows through a single endpoint.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: ComOS-Federation
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ComOS-Federation/comos-mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/comos-federation-gateway

## What it does

The gateway hooks any MCP client into a multi-tenant commerce grid over streamable HTTP. Nothing runs locally because the server is fully hosted. The endpoint accepts `POST` requests and rejects plain browser `GET` requests with a method-not-allowed message.

Unauthenticated agents can query connected storefronts via `federation_list_tenants`, browse inventory, check prices, and fetch external card checkout links via `pay_url`. Direct agent-driven ordering requires a logged-in user profile; otherwise, the gateway rejects the checkout action and returns sign-in guidance.

Joining costs nothing upfront, but completed sales carry a 3% network cut alongside standard card processing fees of 2.9% plus $0.30. Certain platform actions consume Coms tokens priced at $0.01 per unit, viewable directly through the `federation_pricesheet` tool.

## Requirements
- Remote server: `https://mcp.comos-federation.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http gateway https://mcp.comos-federation.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add comos-federation-gateway --url https://mcp.comos-federation.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "comos-federation-gateway": {
            "url": "https://mcp.comos-federation.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "comos-federation-gateway": {
            "type": "http",
            "url": "https://mcp.comos-federation.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http comos-federation-gateway https://mcp.comos-federation.com/mcp
```

## When to use it
- Route natural language product searches to storefronts via `federation_search`
- Read inventory, prices, and operating hours via `federation_enter_tenant` and `federation_view`
- Generate card checkout links for buyers through the `pay_url` attribute
- Review vendor terms and onboarding requirements using `federation_offer`

## Example prompts
- List all active stores across the network using `federation_list_tenants`
- Search available catalog items using `federation_search`
- Check the platform rate card by calling `federation_pricesheet`

## Similar
- [UCP Gateway](https://affpapa.org/en/nevibecode/mcp/ucp-gateway.md) — MCP server · 3618 installs
- [MCP Gateway](https://affpapa.org/en/nevibecode/mcp/mcp-gateway.md) — MCP server · ★ 91 repo stars
- [Agent MCP Gateway](https://affpapa.org/en/nevibecode/mcp/agent-mcp-gateway.md) — MCP server · ★ 42 repo stars
- [IdentArk Gateway](https://affpapa.org/en/nevibecode/mcp/identark-gateway.md) — MCP server · ★ 16 repo stars
- [Perforce Agentic Gateway](https://affpapa.org/en/nevibecode/mcp/perforce-agentic-gateway.md) — MCP server · ★ 14 repo stars
- [mcp-gateway](https://affpapa.org/en/nevibecode/mcp/rupinder2-mcp-gateway.md) — MCP server · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
