Skip to main content
MCP (Model Context Protocol) is an open standard that lets AI assistants call tools and read data on your machine, instead of guessing from chat alone. Bruno MCP is the MCP server for Bruno. Connect it once in Cursor, VS Code, Claude Code, Claude Desktop, or any other MCP client. The assistant can list collections, inspect requests and environments, run them through the Bruno CLI, and create or edit collection files.
Install Bruno MCP in CursorInstall Bruno MCP in VS Code
Bruno is an open source, offline-first API client. Collections live as plain text files in a folder, versioned with Git. Bruno MCP brings that same philosophy to AI workflows.

Why Bruno fits MCP naturally

Bruno collections are plain files on disk (.bru or OpenCollection YAML). That already works well with AI agents that can read a repo. MCP goes further. Bruno stays local-first and Git-friendly. MCP does not move your collections to the cloud. It gives the assistant a safer, clearer API over the same files you already version-control.

What you can do

  • Ask questions about an API from its collection (“Which endpoints need auth?”)
  • Run a request or a whole collection and get the results explained
  • Write requests for endpoints in the codebase that the collection does not cover yet
  • Probe edge cases, find a bug, fix the code, then add a request with tests that guards against it
  • Add assertions and test scripts to existing requests
  • Update environment variables, such as a base URL

Example prompts

  • “Create an API collection for the product codebase”
  • “List the requests in the payments collection that use POST.”
  • “Run the orders folder against staging and summarize the failures.”
  • “Add Bruno requests for the endpoints in src/routes that the collection does not cover.”
  • “Add a test to Create order that checks the total is price times quantity.”
  • “Set baseUrl in the staging environment to https://api.example.com.”

Requirements

  • Node.js 20.12 or later
  • A Bruno collection in .bru or OpenCollection YAML (.yml)
  • An MCP client (Claude Code, Cursor, VS Code, Claude Desktop, Codex, and others)
The package is @usebruno/mcp on npm. Clients typically start it with npx -y @usebruno/mcp. The Bruno CLI is bundled with the MCP server, so you do not install it separately.

Security at a glance

  • Runs locally over stdio on your machine
  • Request headers that carry credentials (Authorization, Cookie, X-Api-Key, and similar) are masked
  • Secret environment variables are masked by default
See Tools for the full tool list, write behavior, and limitations.

Next steps

  • Setup. Connect Cursor, VS Code, Claude Code, and other clients.
  • Tools - Read, run, and write tools the assistant can call.
  • Bruno CLI - The CLI the MCP server uses to execute requests.
  • Model Context Protocol - The open standard.