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?"