Bruno MCP Studio — Claude Code MCP server: what it does
Bruno MCP Studio — an MCP server that writes and runs Bruno collections (HTTP, WebSocket, gRPC) from an agent. The result is .bru files that open in Bruno GUI and work in CI.
MIT ★ 11 updated 2026-09-24
claude mcp add bruno-mcp-studio -- npx -y @ostico/bruno-mcpWhat Bruno MCP Studio does
The server gives an agent eighteen tools for API testing: create requests, read them as JSON, manage variables and environments, write assertions and test scripts, run the collection with auth, cookies and request dependencies — all in one call. Files are saved in Bruno format and work with bru run.
Inside is a custom runner (not a CLI wrapper) that keeps secrets in memory and supports multiple identities in a single request group. The server uses Bruno's grammar package (@usebruno/lang) for serialization: the bytes on disk match what Bruno itself writes, including both format dialects. Partial edits leave the rest of the file alone.
The server does not depend on Bruno GUI or the bru binary. Requests are read and written via MCP tools, execution happens in the server process. Run results come back to the agent with pass/fail per request.
What it helps with
- write Bruno collections from an agent without guessing format syntax
- run HTTP, WebSocket and gRPC requests with auth and dependencies
- read existing
.brufiles as structured JSON - test APIs with multiple identities in a single group
- save test results as files that work in CI
Example prompts for the agent
- Create a Bruno collection for the
/usersAPI with GET and POST requests - Run all requests from the
api-testscollection and show the results - Read the
login.brurequest and output its variables and headers
How to install Bruno MCP Studio
Platform CLI
claude mcp add bruno-mcp-studio -- npx -y @ostico/bruno-mcpPlatform CLI
codex mcp add bruno-mcp-studio -- npx -y @ostico/bruno-mcpConfig file
{
"mcpServers": {
"bruno-mcp-studio": {
"command": "npx",
"args": [
"-y",
"@ostico/bruno-mcp"
]
}
}
}Config file
{
"servers": {
"bruno-mcp-studio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ostico/bruno-mcp"
]
}
}
}Platform CLI
gemini mcp add bruno-mcp-studio npx -y @ostico/bruno-mcpStep 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 Bruno MCP Studio
How to install Bruno MCP Studio in Claude Code?
Run claude mcp add bruno-mcp-studio -- npx -y @ostico/bruno-mcp.
What does Bruno MCP Studio do?
The server writes and runs Bruno collections (HTTP, WebSocket, gRPC) via MCP tools. The agent creates requests, edits variables and environments, runs tests with auth and dependencies. The result is .bru files that work in Bruno GUI and CI.
How does Bruno MCP Studio differ from the official Bruno MCP server?
The official server usebruno/bruno-mcp wraps the bru CLI and runs existing collections. Bruno MCP Studio writes and edits .bru files from inside (via the @usebruno/lang package), keeps the runner in-process, and supports multiple identities, gRPC and WebSocket.