---
title: Integrate with AI
description: Use SuperTokens documentation directly in AI chat and coding tools.
sidebar:
  icon: sparkles
  order: 31
---

## Ask AI

Use the **Ask AI** action in the documentation to ask questions about SuperTokens. It answers from the current page and relevant SuperTokens documentation, and includes links to the pages it used.

## Connect an AI coding agent

Connect your AI coding tool to the public, read-only SuperTokens documentation MCP server. The server lets an agent search and read the documentation without scraping web pages or requiring credentials.

```bash
claude mcp add --transport http supertokens-docs https://supertokens.com/docs/mcp
```

Use the **Connect to MCP** action on any documentation page for client-specific setup instructions.

The server exposes these tools:

- `search_docs`: Search the documentation and return matching pages with excerpts.
- `get_page`: Read a documentation page as agent-optimized Markdown.
- `list_pages`: List every page with its route, title, description, and content type.
- `get_navigation`: Read the documentation navigation hierarchy.


## Machine-readable documentation

### Markdown responses

AI tools can request agent-optimized Markdown instead of HTML by sending an `Accept: text/markdown` header. This preserves the tool's context window and includes supported components as plain Markdown.

```bash
curl -sL -H "Accept: text/markdown" https://supertokens.com/docs/integrate-with-ai
```

### Direct Markdown routes

Append `.md` to a documentation URL to retrieve agent-optimized Markdown. Append `.mdx` to retrieve the original MDX source.

For example: [integrate-with-ai.md](https://supertokens.com/docs/integrate-with-ai.md).

Use **Copy as Markdown** to copy the current page, or **Open in chat** to open it in a supported AI assistant with the page context.

### Site indexes

The documentation also provides machine-readable site indexes:

- [/llms.txt](https://supertokens.com/docs/llms.txt) is a compact, structured index of the documentation.
- [/llms-full.txt](https://supertokens.com/docs/llms-full.txt) contains the full documentation corpus. It can exceed an AI tool's context window.
- [/agent-readability.json](https://supertokens.com/docs/agent-readability.json) advertises these agent-facing documentation surfaces for automatic discovery.

The dashboard application owns MCP discovery under `/.well-known`. Connect clients directly to the MCP URL above.