Getting Started

MCP Server

Use Air UI docs directly inside AI assistants with Model Context Protocol (MCP).

What is MCP?

MCP (Model Context Protocol) is a standard way for AI assistants to access external tools and data.

The Air UI MCP server exposes documentation search and retrieval tools so assistants can answer with project-specific, up-to-date information instead of generic guesses.

Endpoint

Air UI docs exposes MCP over this public endpoint:

 https://air-ui.netlify.app/mcp

Available tools

The current server provides these tools:

Tool	What it does
`list_doc_pages`	Lists available docs pages with title, path, and description.
`search_docs`	Searches docs pages by keyword.
`get_doc_page`	Fetches full content for a specific docs path.

Available prompts

The server also includes guided prompts for common workflows:

Prompt	What it does
`list-doc-pages`	Get a list of all available documentation pages with their titles and descriptions.
`navigate-docs`	Helps the model find relevant docs efficiently.
`explain-doc`	Explains a doc page in developer-friendly language.
`generate-example`	Generates practical examples from documentation context.

Configuration

Visual Studio Code

Quick install

Use this deeplink to install directly in VS Code:

Install MCP in VS Code

Manual setup

Create or update .vscode/mcp.json in your project:

 {
    "servers": {
        "airui": {
            "type": "http",
            "url": "https://air-ui.netlify.app/mcp"
        }
    },
    "inputs": []
}

Claude Code

Quick install

Run this command:

 claude mcp add --transport http airui https://air-ui.netlify.app/mcp

Manual setup

You can also add the same server from your Claude MCP configuration file.

Cursor

Quick install

Use this deeplink to install directly in Cursor:

Install MCP in Cursor

Manual setup

Create or update .cursor/mcp.json in your project root:

 {
    "mcpServers": {
        "airui": {
            "type": "http",
            "url": "https://air-ui.netlify.app/mcp"
        }
    }
}

Gemini CLI

Add this to your Gemini CLI settings file (usually ~/.gemini/settings.json):

 {
    "mcpServers": {
        "airui": {
            "url": "https://air-ui.netlify.app/mcp"
        }
    }
}

Google Antigravity

Open MCP settings in Antigravity and add this server to your raw MCP config:

 {
    "mcpServers": {
        "airui": {
            "serverUrl": "https://air-ui.netlify.app/mcp"
        }
    }
}

Usage examples

After configuration, try prompts like:

"List all Air UI documentation pages"
"Search docs for MCP server"
"Get the full page for /docs/getting-started/installation-from-existing"
"Explain how to install Air UI in an existing Nuxt project"
"Generate a practical example from the installation docs"

Design tokens

Learn how to customize the design tokens of AirUI.

LLMs.txt

Learn about the LLMs.txt file and how to use it with AirUI.