Baton
Local MCP server to edit git-native API requests, environments and scripts in Baton
- Pricing
- Free
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- 3 days ago
About Baton
Baton is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Baton keeps API requests, collections and environments as plain YAML files in a git repository, and this local stdio server (npm package @dudko.dev/baton-mcp, Node.js 24 or later) lets an assistant work in that workspace. It has two modes chosen at start. In file mode the assistant writes the same YAML the app would, so every edit goes through git review, and it cannot send requests unless you add --allow-run.
In app mode, with the Baton desktop app open on the workspace, edits arrive as drafts on the request's tab for you to accept or discard. Sends run through the app using its secrets, and a send into a production environment or a delete waits for your confirmation. The assistant can also see which request and environment you have open.
Secrets never pass through the server: environments list secret names and sources only. Tools also cover scripts, saved response examples and local mock servers that answer from examples on 127.0.0.1. There is no auth because it runs locally with your user's permissions. Baton itself is free for personal, non-commercial use.
Install
Run in a terminal
claude mcp add baton -- npx -y @dudko.dev/baton-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"baton": {
"command": "npx",
"args": [
"-y",
"@dudko.dev/baton-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"baton": {
"command": "npx",
"args": [
"-y",
"@dudko.dev/baton-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"baton": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dudko.dev/baton-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"baton": {
"command": "npx",
"args": [
"-y",
"@dudko.dev/baton-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"baton": {
"command": "npx",
"args": [
"-y",
"@dudko.dev/baton-mcp"
]
}
}
}Tools this server provides (20)
Taken from the project documentation; the running server may differ.
- workspace_info
- Lists collections, environments, schedules, load issues and app connection.
- list_requests
- Lists requests with method, URL and tags.
- get_request
- Returns a parsed request and its raw YAML.
- upsert_request
- Writes a request or proposes it as a draft.
- move_request
- Moves or renames a request.
- delete_request
- Deletes a request.
- upsert_collection
- Creates or replaces a collection or folder.
- list_environments
- Lists variables and secret names.
- upsert_environment
- Writes an environment.
- get_script
- Reads a script.
- upsert_script
- Writes a script.
- run_request
- Executes a request.
- run_collection
- Executes every request under a collection.
- list_examples
- Lists a request's saved responses.
- save_example
- Saves the last response as an example.
- list_mocks
- Lists mocks.
- start_mock
- Starts a local mock.
- stop_mock
- Stops a mock.
- app_state
- Shows what is open in the app.
- select_request
- Opens a request in the app.
What it does
- File and app modes
- Edit YAML directly, or propose drafts inside the open Baton app.
- Request and collection editing
- Create, move, rename and delete requests, collections and folders.
- Secret-safe environments
- Only secret names and sources are visible, never values.
- Script access
- Read and write pre-request, test and shared library scripts.
- Local mocks
- Start mocks from YAML files that answer from saved examples.
- Confirmation gates
- Production sends and deletes wait for your approval in app mode.
Good for
- Have an assistant add a request to a collection as a reviewable diff
- Rename or move requests without losing their scripts
- Draft test scripts for existing requests
- Run a collection through the app and review the results
- Spin up a mock API from saved examples
Pricing
Free
Baton is free for personal, non-commercial use; commercial licensing by contact
Prices change. Check baton.dudko.dev before you buy.
Baton FAQ
Can the assistant send requests?
In file mode only with --allow-run; in app mode every send goes through the app on your screen.
What does it need?
Node.js 24 or later and a Baton workspace, the folder with baton.yaml.
Does it handle my secrets?
No. Secrets never pass through it; it sees only names and sources.
Is Baton free to use at work?
No. The free licence covers personal, non-commercial use; company use needs a commercial licence.
Is Baton free?
Yes. Baton is free to use.
How do I add Baton to Claude Code?
Run this command in your terminal: claude mcp add baton -- npx -y @dudko.dev/baton-mcp
What are the best alternatives to Baton?
The closest alternatives to Baton are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Baton

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools