# AI & MCP

These docs are built to be read by AI assistants and coding agents as well as people.

## MCP server

Connect any MCP client to:

```
https://docs.gmjroaming.com/mcp
```

It's **read-only** and needs no API key. It can search the guides and read the full API
reference. It can't call the API or see your account.

| Tool | What it does |
| --- | --- |
| `search_docs` | Search guides and endpoints |
| `read_page` | Read one guide as Markdown |
| `list_endpoints` | List v1 or v2 endpoints |
| `get_endpoint` | Full definition of one endpoint, with schemas |

**Claude Code**

```bash
claude mcp add --transport http gmj-roaming-docs https://docs.gmjroaming.com/mcp
```

**Cursor / VS Code / others**: add an HTTP MCP server with the URL above. The [MCP page](/mcp-server)
has copy-paste setup for each client.

## Plain text for LLMs

| URL | Contents |
| --- | --- |
| [`/llms.txt`](/llms.txt) | Index of every page |
| [`/llms-full.txt`](/llms-full.txt) | All guides in one file |
| `/<page>.md` | Any guide as Markdown |
| [`/openapi/v1.yaml`](/openapi/v1.yaml) | v1 OpenAPI spec |
| [`/openapi/v2.yaml`](/openapi/v2.yaml) | v2 OpenAPI spec (alpha) |

Each page also has **Use in Claude** and **Use in ChatGPT** buttons.