Integrate with AI
Use SuperTokens documentation directly in AI chat and coding tools.
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.
claude mcp add --transport http supertokens-docs https://supertokens.com/docs/mcpUse 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.
curl -sL -H "Accept: text/markdown" https://supertokens.com/docs/integrate-with-aiDirect 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.
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 is a compact, structured index of the documentation.
- /llms-full.txt contains the full documentation corpus. It can exceed an AI tool’s context window.
- /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.