# MCP Server

aimock's documentation and source code are indexed by a Pathfinder instance, giving AI agents semantic search and file exploration via MCP.

## Available Tools

The MCP server exposes five tools that agents can use to find information about aimock:

Tool | Description
--- | ---
`search-docs` | Semantic search over aimock documentation — guides, API references, provider configs
`search-code` | Semantic search over aimock's TypeScript source — routers, handlers, builders
`explore-docs` | Browse documentation files with bash commands (find, grep, cat, ls, head)
`explore-code` | Browse source code files with bash commands
`submit-feedback` | Report whether search results were helpful to improve quality

## Connect Your Agent

### Claude Code

Add via the CLI:

Terminal bash

    claude mcp add aimock-docs --transport http https://mcp.aimock.copilotkit.dev/mcp

Or add to `~/.claude/mcp.json`:

~/.claude/mcp.json json

    {
      "mcp-servers": {
        "aimock-docs": {
          "type": "http",
          "url": "https://mcp.aimock.copilotkit.dev/mcp"
        }
      }
    }

### Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json json

    {
      "mcpServers": {
        "aimock-docs": {
          "type": "http",
          "url": "https://mcp.aimock.copilotkit.dev/mcp"
        }
      }
    }

### Cursor

.cursor/mcp.json json

    {
      "mcpServers": {
        "aimock-docs": {
          "type": "http",
          "url": "https://mcp.aimock.copilotkit.dev/mcp"
        }
      }
    }

### OpenAI Codex

codex-mcp.json json

    {
      "mcpServers": {
        "aimock-docs": {
          "type": "http",
          "url": "https://mcp.aimock.copilotkit.dev/mcp"
        }
      }
    }

Then run: `codex --mcp-config codex-mcp.json`

### VS Code (Continue)

~/.continue/config.json json

    {
      "mcpServers": [
        {
          "name": "aimock-docs",
          "transport": {
            "type": "http",
            "url": "https://mcp.aimock.copilotkit.dev/mcp"
          }
        }
      ]
    }

### Generic (Streamable HTTP)

Any MCP-compatible client can connect via Streamable HTTP:

Endpoint text

    URL:       https://mcp.aimock.copilotkit.dev/mcp
    Transport: Streamable HTTP
    Method:    POST

## What Gets Indexed

The MCP server indexes two sources from the aimock repository:

- Documentation — all HTML pages from `docs/`, chunked for semantic search with source URLs back to aimock.copilotkit.dev
- Source code — TypeScript files from `src/`, excluding tests, chunked by logical code blocks

The index auto-refreshes daily and on push via GitHub webhooks, so agents always search against the latest content.

## Verifying the Connection

Once connected, your agent should see the aimock tools in its available tools list. Try asking your agent:

- "Search aimock docs for how to mock streaming responses"
- "Explore the aimock source code for the router implementation"
- "How do I use fixtures with aimock?"