# gc-mcp

> Ground Control MCP Server — multi-agent task dispatch, Notion offloading, and claw propagation via Model Context Protocol.

## Endpoints

| Endpoint | Transport | URL |
|---|---|---|
| Streamable HTTP | MCP 2025-03-26 | https://api.optimizationinversion.com/mcp |
| Streamable HTTP | MCP 2025-03-26 | https://gc-api.genesisconductor.io/mcp |
| Streamable HTTP | MCP 2025-03-26 | https://gc-mcp.iholt.workers.dev/mcp |
| SSE | Legacy | https://api.optimizationinversion.com/sse |
| SSE | Legacy | https://gc-api.genesisconductor.io/sse |
| SSE | Legacy | https://gc-mcp.iholt.workers.dev/sse |
| JSON-RPC | Backward compat | https://api.optimizationinversion.com/ |
| JSON-RPC | Backward compat | https://gc-api.genesisconductor.io/ |
| JSON-RPC | Backward compat | https://gc-mcp.iholt.workers.dev/ |
| Health | HTTP GET | https://api.optimizationinversion.com/health |
| Health | HTTP GET | https://gc-api.genesisconductor.io/health |
| Health | HTTP GET | https://gc-mcp.iholt.workers.dev/health |

## Tools

| Tool | Description |
|---|---|
| `submit_hybrid_task` | Dispatch hybrid workflow task to Codex agent |
| `submit_opus_notion_task` | Dispatch Opus+Notion workflow task to Claude |
| `submit_opus_task` | Dispatch pure Opus workflow task to Claude |
| `offload_to_notion` | Offload session context to Notion soul-capsule DB |
| `propagate_to_claws` | Fan-out payload to Slack, Telegram, OpenClaw, KimiClaw, NemoClaw |

## Transport Details

This server implements the [Model Context Protocol](https://modelcontextprotocol.io/) specification version 2025-03-26.

### Streamable HTTP (Recommended)

```json
{ "mcpServers": { "gc-mcp": { "url": "https://api.optimizationinversion.com/mcp", "transport": "streamable-http" } } }
```

### SSE (Legacy)

```json
{ "mcpServers": { "gc-mcp": { "url": "https://api.optimizationinversion.com/sse", "transport": "sse" } } }
```

## Authentication

Optional Bearer token via `GC_MCP_INGRESS_AUTH` secret. Include `Authorization: Bearer <token>` header on requests.

## Well-Known URIs

- `/.well-known/mcp` — MCP server discovery (JSON)
- `/.well-known/ai-plugin.json` — OpenAI plugin manifest
- `/.well-known/openapi.json` — OpenAPI 3.1 specification

## Crawling & Indexing

- `/robots.txt` — crawler directives
- `/sitemap.xml` — sitemap for search engine discovery
- `/llms.txt` — this file (LLM-readable documentation)

---

Maintained by Optimization Inversion / Genesis Conductor.