> ## Documentation Index
> Fetch the complete documentation index at: https://tyk.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Natural-language interaction with Tyk Docs (MCP)

> Talk to Tyk documentation like a person using AI tools. Use Docs MCP to enable AI assistants to search and retrieve information from Tyk documentation.

## Overview

Tyk Docs [MCP](https://modelcontextprotocol.io/introduction) exposes the Tyk documentation to AI assistants. Instead of searching manually, users can ask natural-language questions and get answers backed by Tyk docs. The tool makes AI-assisted support, troubleshooting, and documentation exploration fast and reliable.

Here you can see the AI assistant chooses to use Tyk Docs MCP (*Cline* in VS Code) while answering the query *How do I set a rate limit for a Tyk API?*:

<img src="https://mintcdn.com/tyk/iulB7pWrSP_hEp45/img/ai-mcp/tyk-docs-mcp-q1-screenshot.png?fit=max&auto=format&n=iulB7pWrSP_hEp45&q=85&s=4f0272029b69c5c012a2934c724d5944" alt="Screenshot of the response to request of AI to create a new user" width="3022" height="1724" data-path="img/ai-mcp/tyk-docs-mcp-q1-screenshot.png" />

<img src="https://mintcdn.com/tyk/iulB7pWrSP_hEp45/img/ai-mcp/tyk-docs-mcp-q2-screenshot.png?fit=max&auto=format&n=iulB7pWrSP_hEp45&q=85&s=95f6fbfa6075ff9dafeff7994b6cad6e" alt="Screenshot of the response to request of AI to create a new user" width="3022" height="1732" data-path="img/ai-mcp/tyk-docs-mcp-q2-screenshot.png" />

## Key Features

* **Semantic search** — finds the most relevant content, not just keyword matches
* **Contextual results** — includes sections around your result for better understanding
* **Product filters** — limit results by product (Gateway, Dashboard, etc.)
* **Includes links** — jump straight into the relevant section of the docs
* **Answer snippets** — shows concise answers when possible
* **Always up to date** — syncs with the latest Tyk documentation

## Use Cases

<a id="use-cases" />

Let AI do the digging — here’s how teams use Tyk Docs MCP:

* **First-line support** - *How do I set a rate limit for a Tyk API?*
  <br />AI can help answer questions about Tyk products, features, and usage cases.

* **Feature implementation help** - *How do I enable JWT authentication in Tyk Gateway?*
  <br />AI can help developers use Tyk's features by providing ad hoc step-by-step instructions and examples.

* **Troubleshooting guidance** - *I'm seeing 'Auth field missing' error. What does that mean?*
  <br />AI can help identify issues and provide guidance on how to resolve them.

* **Fast API reference** - *What fields are in the /apis response?*
  <br />AI can help developers quickly find the information they need to implement Tyk's features.

* **Discover what’s possible** - *What analytics tools does Tyk include?*
  <br />AI can help developers discover new ways to use Tyk's features and capabilities.

## Quick Start

To get started, connect your AI assistant to the Tyk Docs MCP server, which is hosted remotely at `https://tyk.io/docs/mcp`.

### Requirements

* [Node.js v18+](https://nodejs.org/en/download) installed (needed to run `npx`)
* Internet access to reach `tyk.io`
* An MCP-compatible AI assistant, such as Claude Code, Claude Desktop, Cursor, VS Code, or Codex

### Configure your AI Assistant

**Step 1.**
The easiest way to connect is the [`add-mcp`](https://github.com/neon-solutions/add-mcp) CLI. It detects the AI assistants installed on your machine and adds the server to whichever ones you choose:

```bash theme={null}
npx add-mcp https://tyk.io/docs/mcp
```

You can also click **Add MCP** in the menu at the top of any Tyk Docs page to get the same command, pre-filled for that page.

<img src="https://mintcdn.com/tyk/1VGm-v0Y99VDSZ6v/img/page-options.png?fit=max&auto=format&n=1VGm-v0Y99VDSZ6v&q=85&s=12063100eab779f2a6f5b5cbab0a953a" alt="Mintlify Context Menu Options" width="1250" height="838" data-path="img/page-options.png" />

If your assistant supports remote HTTP MCP servers but isn't detected automatically, add the server to its MCP configuration manually instead:

```json theme={null}
{
  "mcpServers": {
    "tyk-docs": {
      "type": "http",
      "url": "https://tyk.io/docs/mcp"
    }
  }
}
```

**Step 2.**
Once connected, ask the AI to perform an operation as suggested in the [use cases above](#use-cases).

## How It Works Under the Hood

Tyk Docs MCP is Mintlify's built-in MCP server for the Tyk Documentation site. It indexes the live, published documentation, so results always reflect the current content, with no local package to install or keep up to date. Aside from a `submit_feedback` tool, which lets a connected assistant report a documentation issue such as an incorrect, outdated, or confusing page directly to the Tyk docs team, the server is read-only.
