# Baton

Connects an AI agent to a Baton workspace so it can edit API requests, collections, environments, and scripts alongside the app.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: dudko-dev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dudko-dev/baton-mcp-setup
- Updated: 2026-09-25
- HTML: https://affpapa.org/en/nevibecode/mcp/dudko-dev-baton

## What it does

Baton keeps API requests, collections, and environments as YAML files in a Git repository. Its local MCP server lets an agent inspect and change those files: create requests and folders, rename or remove requests, and edit pre-request or test scripts. Updates appear in the app, while commits stay under your control.

Request execution is disabled by default. Add `--allow-run` to permit running requests or collections. The server handles secret names and references rather than plaintext values. It requires Node.js 24+, and the workspace needs a `baton.yaml` file when the server starts; otherwise the MCP connection closes.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add baton -- npx -y @dudko.dev/baton-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add dudko-dev-baton -- npx -y @dudko.dev/baton-mcp
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add dudko-dev-baton npx -y @dudko.dev/baton-mcp
```

## When to use it
- inspect an API workspace’s collection tree and requests
- create or update a request as YAML
- rename or move a request without changing its ID
- edit an environment while keeping secrets as references
- read or change request and test scripts

## Example prompts
- List the collections and requests in my current Baton workspace.
- Create an API request and save it to the Baton workspace.
- Update this request’s test script without executing the request.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

## Other versions with the same name
- [baton · kaseban](https://affpapa.org/en/nevibecode/mcp/baton.md) — ★ 27

---
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