# omarchyspaces.com API

Read-only, public, no key, CORS open. OpenAPI: https://omarchyspaces.com/openapi.json · catalog: https://omarchyspaces.com/.well-known/api-catalog

## Files

- https://omarchyspaces.com/episodes.json: every episode's metadata
- https://omarchyspaces.com/ep/NN/episode.json, index.md, summary.md, transcript.txt (NN = two digits)
- https://omarchyspaces.com/builders.json, https://omarchyspaces.com/asks.json
- https://omarchyspaces.com/llms.txt, https://omarchyspaces.com/llms-full.txt
- https://omarchyspaces.com/version.json: status (when the site was built)
- Any HTML page with `Accept: text/markdown` returns its Markdown twin.

## MCP

Endpoint https://omarchyspaces.com/mcp, Streamable HTTP, stateless, protocol 2025-06-18, no auth. Card: https://omarchyspaces.com/.well-known/mcp/server-card.json

- `list_episodes`: Every episode of the Omarchy! Omarchy! Omarchy! X Space: number, title, date, one-paragraph blurb and links.
- `get_episode`: One episode by number. part=markdown (default: facts, summary and transcript), summary (Fred's post on X), transcript (plain text) or metadata (JSON).
- `search`: Find paragraphs in every summary and transcript that contain all the words in the query. Returns each hit with its episode and link.
- `list_builders`: Everyone who has come up to the mic: X handle, which episodes, and one line from the summaries about what they build.
- `get_board`: Every ask from the room (help wanted, collaborators wanted) and every question nobody has answered yet, each with its episode.
- `next_space`: When and where the next live X Space is (every Sunday, 3pm America/New_York) and how to join.

Example:

```
curl -s https://omarchyspaces.com/mcp -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"Omarchy phone"}}}'
```

## A2A

Agent https://omarchyspaces.com/a2a, JSON-RPC, A2A 1.0 (0.3 `message/send` also accepted), no auth. Card: https://omarchyspaces.com/.well-known/agent-card.json
Send a plain-language message; it answers with the site's own text.

```
curl -s https://omarchyspaces.com/a2a -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"1","role":"ROLE_USER","parts":[{"text":"episode 7 summary"}]}}}'
```