# AI tools and MCP (/ai-tools)

These docs are built to be read by AI tools as well as people, so an assistant can write your Alienmail integration with the real endpoints and rules.

## Copy page and open in AI apps [#copy-page-and-open-in-ai-apps]

Every page has a **Copy page** button at the top. Its menu has:

- **Copy page**: the page as Markdown, ready to paste into a chat.
- **View as Markdown**: the plain-text version of the page.
- **Open in ChatGPT** and **Open in Claude**: start a chat that reads the page.
- **llms.txt**: the index of the whole site for language models.

## Markdown and llms.txt [#markdown-and-llmstxt]

| URL | What it is |
|---|---|
| [`/llms.txt`](/llms.txt) | An index of every page with a short description, in the [llms.txt](https://llmstxt.org) format. |
| [`/llms-full.txt`](/llms-full.txt) | All pages in one Markdown file, including every endpoint of the API reference. |
| `/<page>.md` | One page as Markdown, like [`/quickstart.md`](/quickstart.md). |
| [`/openapi.json`](/openapi.json) | The OpenAPI 3.1 spec of the API. |

Pages also answer with Markdown when a tool asks for it with `Accept: text/markdown`.

## Docs MCP server [#docs-mcp-server]

The docs have a [Model Context Protocol](https://modelcontextprotocol.io) server, so AI coding tools can search and read them while they work. It is public and read-only, and needs no sign-in.

```txt
https://docs.alienmail.io/api/mcp
```

It has three tools:

| Tool | What it does |
|---|---|
| `search` | Searches the docs. |
| `list_pages` | Lists every page with its URL. |
| `get_page` | Returns a page as Markdown. |

### Connect your tool [#connect-your-tool]

<Tabs items={["Claude Code","Cursor","VS Code","Claude","Other"]}>
<Tab value="Claude Code">
```bash
claude mcp add --transport http alienmail-docs https://docs.alienmail.io/api/mcp
```
</Tab>

<Tab value="Cursor">
Add to `.cursor/mcp.json` in your project, or to `~/.cursor/mcp.json` for every project:

```json
{
  "mcpServers": {
    "alienmail-docs": { "url": "https://docs.alienmail.io/api/mcp" }
  }
}
```
</Tab>

<Tab value="VS Code">
Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "alienmail-docs": { "type": "http", "url": "https://docs.alienmail.io/api/mcp" }
  }
}
```
</Tab>

<Tab value="Claude">
In Claude, open **Settings → Connectors**, choose **Add custom connector**, and enter `https://docs.alienmail.io/api/mcp`.
</Tab>

<Tab value="Other">
Any client that supports remote MCP servers over Streamable HTTP can use `https://docs.alienmail.io/api/mcp`.
</Tab>
</Tabs>

Then ask, for example: _"Using the Alienmail docs, write a function that adds our new trial users to an Alienmail campaign."_

<Callout type="info">
The docs MCP server reads documentation only. It can't see or change your Alienmail data. To let an AI tool work with your account, connect the [Alienmail MCP server](/guides/mcp-server): sign in from the AI tool, or use an [API key](/authentication).
</Callout>