# Kurlo

> Kurlo is an open-source MCP server for developer tools. Let assistants run and write the saved API requests in a Kurlo workspace. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://kurlo.dev/docs/guides/mcp-server/
- **Repository:** https://github.com/stormhop/kurlo
- **MCP Registry name:** dev.kurlo/kurlo
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Kurlo is an open source API client that keeps requests as readable YAML files, and kurlo mcp serves a workspace to an assistant over stdin and stdout. The assistant can see collections and environments, run a saved request and read the response, run a collection's tests, or send a one-off call that uses an environment's variables.

It can also write: add and change saved requests with tests, write tests from a response, save responses as examples and set environment variables. An agent adding an endpoint to your service can add its request in the same commit, and the app, if open, shows the change within a second.

One command, npx -y @kurlo/cli mcp install --env Local, adds it to Claude Code, Claude Desktop, Codex, Cursor, VS Code, Windsurf and Gemini CLI. The --read-only flag installs only tools that read and run, and --workspace picks a folder.

## Features

- **Run saved requests:** Executes requests and returns responses with the app's engine.
- **Collection tests:** Runs a collection's tests from the assistant.
- **Workspace writes:** Adds requests, tests, examples and environment variables.
- **One-command install:** Configures all detected AI clients at once.
- **Read-only mode:** Installs only the tools that read and run.

## Good for

- Run an endpoint after changing code
- Write tests from a real response
- Add a request in the same commit as an endpoint
- Share a Git-based workspace

## Install

### Claude Code (Terminal)

```sh
claude mcp add kurlo -- npx -y @kurlo/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kurlo": {
      "command": "npx",
      "args": [
        "-y",
        "@kurlo/cli"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kurlo": {
      "command": "npx",
      "args": [
        "-y",
        "@kurlo/cli"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kurlo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@kurlo/cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kurlo": {
      "command": "npx",
      "args": [
        "-y",
        "@kurlo/cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kurlo": {
      "command": "npx",
      "args": [
        "-y",
        "@kurlo/cli"
      ]
    }
  }
}
```

## FAQ

### Is an account needed?

The site says no account is needed.

### How does the assistant connect?

It starts kurlo mcp itself and talks over stdio.

### Can I limit it?

Yes, --read-only installs only tools that read and run.

### Where does it come from?

The @kurlo/cli npm package, via npx.

### Is Kurlo free?

Yes. Kurlo is open source, so you can use and self-host it for free.

### How do I add Kurlo to Claude Code?

Run this command in your terminal: claude mcp add kurlo -- npx -y @kurlo/cli

### What are the best alternatives to Kurlo?

The closest alternatives to Kurlo are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/kurlo
