# Bruno MCP Studio

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 repo stars
- Author: Ostico
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Ostico/bruno-mcp-studio
- Updated: 2026-09-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/bruno-mcp-studio

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- A remote (HTTP) option exists: the address is in the README

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add bruno-mcp-studio -- npx -y @ostico/bruno-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add bruno-mcp-studio -- npx -y @ostico/bruno-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bruno-mcp-studio": {
            "command": "npx",
            "args": [
                "-y",
                "@ostico/bruno-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bruno-mcp-studio": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@ostico/bruno-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add bruno-mcp-studio npx -y @ostico/bruno-mcp
```

## When to use it
- write Bruno collections from an agent without guessing format syntax
- run HTTP, WebSocket and gRPC requests with auth and dependencies
- read existing `.bru` files as structured JSON
- test APIs with multiple identities in a single group
- save test results as files that work in CI

## Example prompts
- Create a Bruno collection for the `/users` API with GET and POST requests
- Run all requests from the `api-tests` collection and show the results
- Read the `login.bru` request and output its variables and headers

## Similar
- [bruno-collection-generator](https://affpapa.org/en/nevibecode/skills/bruno-collection-generator.md) — skill · 621 installs
- [atest-mcp-server](https://affpapa.org/en/nevibecode/mcp/atest-mcp-server.md) — MCP server · ★ 8 repo stars
- [Multimeter](https://affpapa.org/en/nevibecode/mcp/multimeter.md) — MCP server · ★ 14 repo stars
- [Webhook Tester — Send & Measure HTTP Endpoints](https://affpapa.org/en/nevibecode/mcp/webhook-tester-send-measure-http-endpoints.md) — MCP server · 2465 installs
- [mockserver](https://affpapa.org/en/nevibecode/mcp/mockserver.md) — MCP server · ★ 5011 repo stars
- [mockd](https://affpapa.org/en/nevibecode/mcp/mockd.md) — MCP server · ★ 156 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
