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/routesthat the collection does not cover.” - “Add a test to Create order that checks the total is price times quantity.”
- “Set
baseUrlin the staging environment tohttps://api.example.com.”
Requirements
- Node.js 20.12 or later
- A Bruno collection in
.bruor OpenCollection YAML (.yml) - An MCP client (Claude Code, Cursor, VS Code, Claude Desktop, Codex, and others)
@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
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.