Skip to content
Download

MCP tools

ToolWhat it does
list_requestsLists saved requests with their path (Collection/Folder/Name), id, protocol, method and URL. Can be filtered to one collection, and searched with query: every word has to appear in the path, method or URL, so post orders finds POST /orders.
get_requestShows how one request is defined: method, URL, query parameters, headers, body, auth type, scripts and browser settings, plus its saved examples with their status, content type and body, so the assistant can compare a live response with the expected one. Credentials are left out: secret rows show <secret>, and a value typed straight into an Authorization, Proxy-Authorization, Cookie or X-API-Key header shows [secret]. A header that holds only a {{variable}} is shown as written.
list_environmentsLists environments and their variables. Secret values are hidden.
check_openapi_syncFor a collection connected to an OpenAPI source, downloads the current spec and lists the operations added, changed, moved or removed since the last sync applied in Kurlo. It changes nothing; you review and apply the changes in the app. Protected environments cannot be used to resolve the source URL.
run_requestSends a saved HTTP, GraphQL, unary gRPC, MCP or AI request. HTTP responses include timings, redirects and TLS details. For MCP, pass mcpMethod as tools/list or tools/call. Pass mcpName and mcpArguments to call a tool, and mcpCursor to read another page.
run_collectionRuns HTTP, GraphQL and unary gRPC requests in order, with per-request results and assertions. Use iterations, delayMs, failFast and a workspace-relative CSV or JSON dataFile. A data file runs one iteration per row. Pass a progressToken for progress after each request.
send_requestSends an unsaved HTTP request. {{variables}} in the URL, headers and body are resolved from the environment.
list_historyLists the requests you recently sent from the Kurlo app, newest first, with status, timing and the saved request each came from. Can be searched, or narrowed to failures.
get_history_entryShows one request you sent from the app and the response you got: status, headers, body, error, test results and script logs. Without an entry it shows the last one.
diagnose_last_failureExplains why a request sent from the app failed. See When a request fails.
import_preview, import_applyPreview imported YAML, then confirm and apply that preview.
list_files, read_file, search_codeList, read or search the read-only source folder supplied with --project-root.
get_docs, save_docsRead or replace Markdown docs for a saved request or collection.
code_snippetGenerate a snippet in cURL, HTTPie, JavaScript, Node.js, Axios, Python, Go, Java, C#, PHP, Ruby, Swift, Kotlin or Rust.
sync_collection, cover_endpointGet a workflow for using the connected source folder to update collection coverage.
list_load_tests, get_load_test, save_load_testList, read or save a collection’s load tests. Omit the test ID to create a test, or keep it to replace its definition.
start_load_test, load_test_status, stop_load_testStart k6 in the background, inspect progress or stop the active run.
list_load_runs, load_test_result, compare_load_runsFind completed runs and compare their summaries by test ID and startedAt timestamp.
start_mock_server, mock_server_log, stop_mock_serverServe a collection’s saved examples on localhost, check the recent request log or stop the server.
list_cookies, clear_cookie_jarInspect cookie metadata for a domain or clear the jar used by this MCP connection.
create_collectionCreates an empty collection.
save_requestCreates or edits any supported request type using workspace YAML. The HTTP and GraphQL shorthand is also available.
patch_requestChanges individual fields of a saved request with JSON Merge Patch.
list_globalsReads globals in the active local profile. Secret values are hidden.
authorize_oauth2Authorizes a saved request for the current session. See OAuth 2.0 sign-in.
apply_changesApplies an ordered batch of workspace edits. Agent Mode reviews the combined diff once.
delete_requestDeletes a saved request and its examples.
save_exampleSaves a response as an example of a request: the response of the last run_request of that request, or one the assistant describes with status and body.
set_variableSets a non-secret variable in an environment, and creates the environment if there is none with that name.
generate_testsWrites a request’s status, Content-Type and JSON schema tests from a real or described response. See Tests from a response.
git_statusShows the branch, its upstream, commits ahead and behind, and which workspace files have uncommitted changes.
git_diffShows the uncommitted diff of the workspace files or one file; with outgoing, the committed changes not pushed yet.
pull_request_urlBuilds the link that starts a pull request for the current branch on GitHub, or a merge request on GitLab and Bitbucket.
git_create_branchCreates a branch from the current commit and switches to it.
git_commitCommits uncommitted workspace files, or only the paths given, with a message. Other files in the repository are never committed.
git_pushPushes the current branch to its remote, never with force. The assistant is told to push only when you ask.

A request can be named by its id, its full path, or just its name when that name is unique. When a name matches more than one request, the tool lists the matches with their ids so the assistant can pick one.

Request and collection runs accept an environment and a variables object of overrides for that call. run_request and send_request return up to 64 KB of the response body by default. An assistant can ask for up to 1 MB with maxBodyBytes. Binary bodies are described but not included.

Live connection tools are available in the desktop app’s Agent Mode. A mock or k6 run started through kurlo mcp belongs to that process and stops when it exits. The cookie jar is local to the process.

Start the server with kurlo mcp /path/to/kurlo-workspace --project-root /path/to/source. Source paths for list_files, read_file and search_code are relative to the connected folder. The server skips symlinks, hidden configuration, credential files and common dependency and build directories. These tools only read the source. Workspace tools still operate on the Kurlo workspace supplied separately.

Call import_preview with a relative file, pasted content or an OpenAPI url. A file path is relative to the source folder when supplied and otherwise to the Kurlo workspace. Supported inputs include OpenAPI and Swagger, Postman v2 collection JSON, Insomnia Export v4 JSON, HAR, and cURL. For Postman v3 Native Git folders, use the desktop importer. Format detection is automatic, or you can pass format explicitly. For a spec with external references, bundle it into one file before importing.

The preview reports the intended collection, requests and environments and shows the YAML diff. Omit collection to create a collection, or supply its name or ID to append requests. Pass workspace when the Kurlo folder contains multiple workspaces and you are creating a collection. If the diff spans several pages, call import_preview again with the importId and nextOffset as offset. Review the result and pass its importId and confirm: true to import_apply. A file changed since the preview requires a new preview. Agent Mode asks you to approve the diff in the chat.