# gc-mcp v2

> Ground Control MCP Server v2 — multi-agent task dispatch, Cloudflare worker management, Notion offloading, claw propagation, durable objects, workflows, and observability via Model Context Protocol 2026-07-28.

## Endpoints

| Endpoint | Transport | URL |
|---|---|---|
| Streamable HTTP | MCP 2026-07-28 | https://mcp.genesisconductor.io/mcp |
| SSE | Legacy | https://mcp.genesisconductor.io/sse |
| JSON-RPC | Backward compat | https://mcp.genesisconductor.io/ |
| Health | HTTP GET | https://mcp.genesisconductor.io/health |

## Tools

| Tool | Description |
|---|---|
| `submit_hybrid_task` | Dispatch a hybrid workflow task to the Codex agent. Returns a task ID for tracking. |
| `submit_opus_notion_task` | Dispatch an Opus+Notion workflow task to the Claude agent. Returns a task ID. |
| `submit_opus_task` | Dispatch a pure Opus workflow task to the Claude agent. Returns a task ID. |
| `offload_to_notion` | Offload a session context buffer to the Notion soul-capsule database via the notion-bridge worker. |
| `propagate_to_claws` | Propagate a payload to configured claw endpoints (slack, telegram, openclaw, kimiclaw, nemoclaw). |
| `get_worker_status` | Get the status and configuration of a Cloudflare Worker. |
| `list_workers` | List all Cloudflare Workers in the account with their status. |
| `query_worker_logs` | Query recent logs from a Cloudflare Worker using Workers Observability. |
| `get_durable_object_state` | Read state from a Durable Object namespace. |
| `execute_workflow` | Execute a Cloudflare Workflow and return the result. |

## Resources

| Resource | Description |
|---|---|
| `gc://workers/list` | List of all Cloudflare Workers with their current status |
| `gc://workers/{worker_name}/status` | Real-time status and configuration of a specific worker |
| `gc://workers/{worker_name}/logs` | Recent log entries from a worker |
| `gc://workers/{worker_name}/metrics` | Performance metrics for a worker (invocations, CPU, errors) |
| `gc://durable-objects/{namespace_name}/objects` | List of objects in a Durable Object namespace |
| `gc://durable-objects/{namespace_name}/objects/{object_id}/state` | Full state of a specific Durable Object |
| `gc://workflows/list` | List of available Cloudflare Workflows |
| `gc://workflows/{workflow_name}/executions` | Recent executions of a workflow |
| `gc://kv/{namespace_name}/keys` | List of keys in a KV namespace |
| `gc://kv/{namespace_name}/keys/{key}` | Value of a specific KV key |
| `gc://r2/{bucket_name}/objects` | List of objects in an R2 bucket |
| `gc://d1/{database_id}/tables` | List of tables in a D1 database |
| `gc://config/gc-mcp` | Current MCP server configuration and capabilities |

## Prompts

| Prompt | Description |
|---|---|
| `debug_worker` | Debug a Cloudflare Worker by analyzing its logs, metrics, and configuration |
| `deploy_worker` | Guide for deploying a new Cloudflare Worker with best practices |
| `design_workflow` | Design a Cloudflare Workflow for durable execution |
| `offload_session` | Offload a session context to Notion for persistence |
| `multi_agent_dispatch` | Dispatch a multi-agent workflow with Codex, Claude, and other agents |
| `analyze_durable_object` | Analyze a Durable Object's state and behavior |

## Transport Details

This server implements the [Model Context Protocol](https://modelcontextprotocol.io/) specification version 2026-07-28.

### Streamable HTTP (Recommended)

```json
{ "mcpServers": { "gc-mcp": { "url": "https://mcp.genesisconductor.io/mcp", "transport": "streamable-http" } } }
```

### SSE (Legacy)

```json
{ "mcpServers": { "gc-mcp": { "url": "https://mcp.genesisconductor.io/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.