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

# Neo Docs MCP

> Give your AI coding assistant direct access to the Neo documentation

<img src="https://mintcdn.com/tvk/gshengpDkF2IXtrN/images/neo-docs-mcp-hero.png?fit=max&auto=format&n=gshengpDkF2IXtrN&q=85&s=eff88baa5afe40469add86adcfc0c156" alt="Neo Docs MCP Hero" width="2048" height="768" data-path="images/neo-docs-mcp-hero.png" />

The Neo Docs MCP server gives AI coding assistants direct access to the latest Neo documentation. Connect it once, then ask your assistant about widgets, theming, utilities, release notes, and migration paths while you work.

## What is MCP?

MCP (Model Context Protocol) is a standard way for AI tools to read external context. The Neo Docs MCP exposes the published Neo docs at `https://neo.tvk.company/mcp`, so your assistant can answer with the same source material you would otherwise search manually.

<Tip>
  We recommend adding the server per project. This keeps the Neo context close to the codebase that needs it and avoids loading unnecessary tools in unrelated projects.
</Tip>

## Connect the MCP

<Tabs>
  <Tab title="Cursor">
    <Steps>
      <Step title="Open your project MCP settings">
        Create or open `.cursor/mcp.json` in your project root.
      </Step>

      <Step title="Add the Neo Docs server">
        <CodeGroup>
          ```json .cursor/mcp.json lines theme={null}
          {
            "mcpServers": {
              "neo-docs": {
                "url": "https://neo.tvk.company/mcp"
              }
            }
          }
          ```
        </CodeGroup>
      </Step>

      <Step title="Enable the server">
        Reload Cursor if needed, then enable `neo-docs` when Cursor detects the new MCP server.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windsurf">
    <Steps>
      <Step title="Create the MCP config">
        Create or open `.windsurf/mcp.json` in your project root.
      </Step>

      <Step title="Add the Neo Docs server">
        <CodeGroup>
          ```json .windsurf/mcp.json lines theme={null}
          {
            "mcpServers": {
              "neo-docs": {
                "url": "https://neo.tvk.company/mcp"
              }
            }
          }
          ```
        </CodeGroup>
      </Step>

      <Step title="Restart or enable tools">
        Restart Windsurf or enable the server from its MCP settings if it does not appear automatically.
      </Step>
    </Steps>
  </Tab>

  <Tab title="VS Code">
    <Steps>
      <Step title="Create the MCP config">
        Create or open `.vscode/mcp.json` in your project root.
      </Step>

      <Step title="Add the Neo Docs server">
        <CodeGroup>
          ```json .vscode/mcp.json lines theme={null}
          {
            "mcpServers": {
              "neo-docs": {
                "url": "https://neo.tvk.company/mcp"
              }
            }
          }
          ```
        </CodeGroup>
      </Step>

      <Step title="Enable the server">
        Reload VS Code and enable the MCP server from your AI extension's tools or MCP settings.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    <Steps>
      <Step title="Create the MCP config">
        Create or open `.claude/mcp.json` in your project root.
      </Step>

      <Step title="Add the Neo Docs server">
        <CodeGroup>
          ```json .claude/mcp.json lines theme={null}
          {
            "mcpServers": {
              "neo-docs": {
                "url": "https://neo.tvk.company/mcp"
              }
            }
          }
          ```
        </CodeGroup>
      </Step>

      <Step title="Restart Claude Code">
        Restart the session so Claude Code loads the new project MCP server.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## What it can help with

With the Neo Docs MCP server enabled, your AI assistant can:

<CardGroup cols={2}>
  <Card title="Answer Neo questions" icon="circle-question">
    Ask about widgets, layouts, utilities, theming, properties, and examples without leaving your editor.
  </Card>

  <Card title="Generate Neo code" icon="wand-magic-sparkles">
    Ask for components or full screens that follow Neo naming, widget structure, and usage patterns.
  </Card>

  <Card title="Follow current docs" icon="book-open">
    Let your assistant reference the latest docs instead of relying only on model training data.
  </Card>

  <Card title="Handle migrations" icon="arrows-rotate">
    Ask your assistant to read release notes and apply documented migration steps across your codebase.
  </Card>
</CardGroup>

## Usage

After connecting the MCP, write natural prompts in your AI assistant:

```md Example prompts lines theme={null}
"Which Neo widget should I use for a searchable picker?"
"Create a settings screen using Neo form components."
"Show me the required setup for Neo theming."
"Migrate this file to the latest Neo release notes."
```

## Troubleshooting

If the server is not available in your assistant:

1. Check that `mcp.json` is valid JSON.
2. Confirm the file is in the correct project-level folder for your tool.
3. Reload or restart the IDE after changing the config.
4. Open your tool's MCP or tools settings and make sure `neo-docs` is enabled.
5. Check your IDE logs for MCP connection errors.