Using a Caido MCP Server

In this tutorial, you will learn how to integrate a Caido MCP Server to be used with Cursor and Claude Code.

Caido MCP Server

The community developed Caido MCP Server provides AI models/agents with a variety of tools and controlled access to project data.

WARNING

The Caido MCP Server is not officially affiliated with Caido.

As with any third-party projects, ensure to review the code and assess the potential security risks before installation and execution.

With contextual awareness of a project's proxied traffic, extensions, and configurations - the Caido MCP Server gives you the ability to instruct AI assistants to:

• Intercept and forward traffic.
• Filter traffic with HTTPQL query statements.
• Send requests via Replay.
• List Automate and Replay sessions.
• Obtain request/response data.
• Create and list findings and scope presets.
• Discover the recorded endpoints in the Sitemap.
• List and switch between projects.
• List workflows and filter presets.

View a complete list of the individual tools.

Installation

To install the Caido MCP Server:

1. Clone the repository.

git clone --branch v1.1.0 https://github.com/c0tton-fluff/caido-mcp-server.git

2. Navigate into the root directory.

cd caido-mcp-server

3. Compile the server.

Linux/macOS

go build -o caido-mcp-server .

Windows

go build -o caido-mcp-server.exe .

View alternative installation methods.

Configuration

Once the server is installed, to connect it to Caido:

1. Launch Caido.

2. Execute the login command with the listening address of the Caido instance as the value of the -u argument.

Linux/macOS

caido-mcp-server login -u http://127.0.0.1:8080

Windows

caido-mcp-server.exe login -u http://127.0.0.1:8080

3. Click on the Allow button to authorize the server.

Configuring an MCP Client

Once the server is installed, configured, and you are authenticated, models/agents can be configured as clients.

Cursor

To use the Caido MCP Server with the Cursor desktop application:

1. Create a ~/.cursor/mcp.json file with the following content (ensure to replace the value of the command key with the path location of your caido-mcp-server binary).

Linux/macOS

{
  "mcpServers": {
    "caido": {
      "command": "/Users/ninjeeter/caido-mcp-server/caido-mcp-server",
      "args": ["serve"],
      "env": {
        "CAIDO_URL": "http://127.0.0.1:8080"
      }
    }
  }
}

Windows

{
  "mcpServers": {
    "caido": {
      "command": "C:\\Users\\ninje\\caido-mcp-server\\caido-mcp-server.exe",
      "args": ["serve"],
      "env": {
        "CAIDO_URL": "http://127.0.0.1:8080"
      }
    }
  }
}

2. Ensure Caido is running and listening at the same address as the value of the CAIDO_URL environment variable (e.g. http://127.0.0.1:8080).

3. Restart Cursor (or click on View in the navigation bar, select Command Palette..., and select Developer: Reload Window).

TIP

To verify the configuration, click on the button to access the Cursor Settings and select Tools & MCP.

4. Click on the + New Chat button.

5. To verify the connection, submit the message "Send a Replay request to example.com".

WARNING

Consider the reduction in oversight before selecting Allowlist MCP Tool.

A new Replay session will be created and a summary of the request and response will be returned.

Claude CLI

To use the Caido MCP Server with the Claude CLI tool:

1. In the configuration object of the ~/.claude.json file, add the following mcpServers object as a field (ensure to replace the value of the command key with the path location of your caido-mcp-server binary).

Linux/macOS

"mcpServers": {
  "caido": {
    "type": "stdio",
    "command": "/Users/ninjeeter/caido-mcp-server/caido-mcp-server",
    "args": ["serve"],
    "env": {
      "CAIDO_URL": "http://127.0.0.1:8080"
    }
  }
}

Windows

"mcpServers": {
  "caido": {
    "type": "stdio",
    "command": "C:\\Users\\ninje\\caido-mcp-server\\caido-mcp-server.exe",
    "args": ["serve"],
    "env": {
      "CAIDO_URL": "http://127.0.0.1:8080"
    }
  }
}

2. Save the changes to .claude.json.

3. Start a Claude session.

claude

4. To verify the connection, submit the message "Send a Replay request to example.com".

WARNING

Consider the reduction in oversight before selecting 2. Yes, and don't ask again for caido - caido_send_request commands in....

A new Replay session will be created and a summary of the request and response will be returned.