Kurlo — Claude Code MCP server: run saved API requests from chat
Connects your agent to the requests in a Kurlo workspace, so it can send them with auth and tests, add new ones, and explain a failed call.
claude mcp add kurlo -- npx -y @kurlo/cliWhat Kurlo does
Kurlo is an open-source API client that keeps collections as YAML files inside a Git repo. The MCP server starts with kurlo mcp and exposes the requests you already have, auth and tests included. Ask the agent to fire one off, attach an assertion, or trace why the last response came back wrong.
Tokens and keys never reach the model: secrets go to the target API, the context stays clean. The server runs from the @kurlo/cli npm package, so the desktop app isn't needed. Imported Postman scripts keep working, since pm.test, pm.expect with chai and pm.sendRequest run unchanged, and require resolves bundled stand-ins for lodash, ajv, tv4, uuid, crypto-js and chai. Node.js and npx have to be on PATH or the server won't start.
What it helps with
- send the requests stored in a collection straight from the agent chat
- attach a test to an existing request and see it pass or fail
- diagnose the last failed call without leaving the editor
- create a new request with the right auth already set
- keep the API collection in Git next to the code it tests
Example prompts for the agent
- Run the
create-orderrequest from the collection and show me the response - Add a 200 status and response schema test to
list-users - Why did the last
logincall fail? Walk me through the response
How to install Kurlo
Platform CLI
claude mcp add kurlo -- npx -y @kurlo/cliPlatform CLI
codex mcp add kurlo -- npx -y @kurlo/cliConfig file
{
"mcpServers": {
"kurlo": {
"command": "npx",
"args": [
"-y",
"@kurlo/cli"
]
}
}
}Config file
{
"servers": {
"kurlo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kurlo/cli"
]
}
}
}Platform CLI
gemini mcp add kurlo npx -y @kurlo/cliStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Kurlo
How do I install Kurlo in Claude Code?
Run claude mcp add kurlo -- npx -y @kurlo/cli.
What does Kurlo do?
It lets an agent run and write the API requests saved in a Kurlo workspace, using their stored auth and tests.
Does the model see my secrets?
No. Credentials are sent to the API itself and stay out of the model's context.
