Lets an AI agent edit podcast audio by removing noise, filler words, and dead air while generating transcripts and show notes.
Also known as barevalue-ai/barevalue-mcp, barevalue-mcp
- Stars
- 3
- Tools
- 12
- Downloads, 30 days
- —
- Latest version
- 1.5.0
- Last commit
- Oct 11, 2026
- License
- —
What is Barevalue MCP?
Barevalue lets an AI agent edit podcast audio by removing noise, filler words, and dead air while generating transcripts and show notes. It exposes 12 tools, such as barevalue_register, barevalue_upload, barevalue_submit_url.
Summary generated from the project's README
About Barevalue MCP server
Barevalue provides an automated audio editing service designed for podcast creators and developers using AI agents. The server allows an agent to take raw recordings and return polished episodes with noise reduction, level correction, and the removal of filler words or dead air. It also generates essential companion content such as transcripts, show notes, and highlight clips for longer recordings.
Users can connect via a hosted HTTP transport or use the npm bridge for local files. The setup is straightforward: agents can register an account using the barevalue_register tool to receive an API key without manual sign-in. It integrates with popular clients like Claude Code, Cursor, and ChatGPT. The service supports various audio formats including MP3, WAV, and FLAC, with files up to 60 minutes or 750 MB. A free tier provides 10 hours of editing per month, and audio is delivered at up to 320 kbps or lossless quality.
What you can do with it
- 1Automated podcast episode polishingAn agent can take a raw audio file and perform a full edit including noise removal and filler word deletion.
- 2Generating show assetsYou can instruct an AI to produce transcripts and show notes directly from a recording.
- 3Iterative audio revisionsA developer can ask the agent to refine an existing edit based on specific feedback or new instructions.
- 4Local file processingUse the npm bridge to allow an agent to upload audio files directly from your local machine.
Written from the project's README. Every use case is checked against a quote from it.
How to install Barevalue MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Barevalue MCP in Claude Code
$ claude mcp add --env 'BAREVALUE_API_KEY=<YOUR_BAREVALUE_API_KEY>' barevalue-mcp -- npx -y barevalue-mcpInstall Barevalue MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"barevalue-mcp": {
"command": "npx",
"args": [
"-y",
"barevalue-mcp"
],
"env": {
"BAREVALUE_API_KEY": "<YOUR_BAREVALUE_API_KEY>"
}
}
}
}Install Barevalue MCP in VS Code
.vscode/mcp.json
{
"servers": {
"barevalue-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"barevalue-mcp"
],
"env": {
"BAREVALUE_API_KEY": "<YOUR_BAREVALUE_API_KEY>"
}
}
}
}Install Barevalue MCP in VS Code CLI
$ code --add-mcp '{"name":"barevalue-mcp","type":"stdio","command":"npx","args":["-y","barevalue-mcp"],"env":{"BAREVALUE_API_KEY":"<YOUR_BAREVALUE_API_KEY>"}}'Install Barevalue MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"barevalue-mcp": {
"command": "npx",
"args": [
"-y",
"barevalue-mcp"
],
"env": {
"BAREVALUE_API_KEY": "<YOUR_BAREVALUE_API_KEY>"
}
}
}
}Install Barevalue MCP in Codex
$ codex mcp add barevalue-mcp --env 'BAREVALUE_API_KEY=<YOUR_BAREVALUE_API_KEY>' -- npx -y barevalue-mcpInstall Barevalue MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.barevalue-mcp] command = "npx" args = ["-y", "barevalue-mcp"] [mcp_servers.barevalue-mcp.env] BAREVALUE_API_KEY = "<YOUR_BAREVALUE_API_KEY>"
Install Barevalue MCP in Gemini CLI
$ gemini mcp add -s user -e 'BAREVALUE_API_KEY=<YOUR_BAREVALUE_API_KEY>' barevalue-mcp npx -- -y barevalue-mcpInstall Barevalue MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"barevalue-mcp": {
"command": "npx",
"args": [
"-y",
"barevalue-mcp"
],
"env": {
"BAREVALUE_API_KEY": "<YOUR_BAREVALUE_API_KEY>"
}
}
}
}Barevalue MCP tools 12
Detected from the READMEbarevalue_registerbarevalue_uploadbarevalue_submit_urlbarevalue_statusbarevalue_contentbarevalue_feedbackbarevalue_request_revisionbarevalue_updatesbarevalue_list_ordersbarevalue_accountbarevalue_estimatebarevalue_validate
| barevalue_register | — | |
| barevalue_upload | — | |
| barevalue_submit_url | — | |
| barevalue_status | — | |
| barevalue_content | — | |
| barevalue_feedback | — | |
| barevalue_request_revision | — | |
| barevalue_updates | — | |
| barevalue_list_orders | — | |
| barevalue_account | — | |
| barevalue_estimate | — | |
| barevalue_validate | — |
Configuration
BAREVALUE_API_KEYSecretOptional Barevalue API key. Without one, barevalue_register gives a new email address a key.
| Name | Description | |
|---|---|---|
| BAREVALUE_API_KEY | Optional Barevalue API key. Without one, barevalue_register gives a new email address a key. | Secret |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablebarevalue-ai/barevalue-mcp is public and reachablegithub.com/barevalue-ai/barevalue-mcp ↗Pass
- Package names this repository as its sourcebarevalue-mcp names barevalue-ai/barevalue-mcp as sourcenpmjs.com/package/barevalue-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-14github.com/barevalue-ai/barevalue-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from barevalue-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 378 msPass
README
View on GitHubBarevalue MCP server
Barevalue edits podcast audio. Your agent hands over a raw recording and gets back a finished episode, with noise and levels fixed and filler words and dead air removed, plus a transcript, show notes and highlight clips for longer episodes.
One call to sign up, no sign-in, 10 free hours of editing a month, delivered at up to 320 kbps or lossless. No payment details, and the agent does not operate an editor.
https://barevalue.com/mcp
Streamable HTTP, nothing to install, no key needed to connect. The agent calls barevalue_register with your email address and gets a key in that one call.
Install
| Client | One line |
|---|---|
| Claude Code | claude mcp add --transport http barevalue https://barevalue.com/mcp |
| Claude Code, with the skill | /plugin install barevalue --marketplace barevalue-ai/barevalue-mcp |
| Claude (web and desktop) | Settings, Connectors, Add custom connector, then paste https://barevalue.com/mcp/connect |
| Cursor | Add "barevalue": { "url": "https://barevalue.com/mcp" } under mcpServers in ~/.cursor/mcp.json |
| ChatGPT | With developer mode on, add a connector and paste https://barevalue.com/mcp/connect |
| Any agent that reads skills | npx skills add barevalue-ai/barevalue-mcp |
| A file on your own disk | claude mcp add barevalue -- npx -y barevalue-mcp (the npm bridge, below) |
There are two addresses for the same server. https://barevalue.com/mcp is open: the agent registers itself and holds its own key. https://barevalue.com/mcp/connect asks you to sign in to your Barevalue account in a browser first, which is what the Claude and ChatGPT connector screens expect.
The Claude Code plugin line needs Claude Code 2.1.275 or later. On an earlier version, run claude plugin marketplace add barevalue-ai/barevalue-mcp and then claude plugin install barevalue@barevalue. The plugin adds the hosted server and the skill in skills/barevalue-podcast-editing, which teaches an agent the order of calls and what to do when one is refused. This repository is also a Cursor plugin (.cursor-plugin/plugin.json).
Cursor also takes an install link: cursor://anysphere.cursor-deeplink/mcp/install?name=barevalue&config=eyJ1cmwiOiJodHRwczovL2JhcmV2YWx1ZS5jb20vbWNwIn0=
The npm bridge, for a recording on your own machine
The hosted server takes a recording by link. For a file on disk it returns a curl command for the agent to run. The npm package barevalue-mcp does that step itself: barevalue_upload takes the path and sends the file.
| You have | Use |
|---|---|
| A recording that already has a link | The hosted server, https://barevalue.com/mcp |
| A recording on this machine (Claude Code, Cursor, any local agent) | Either. With this package the agent has no command to run |
The package is a bridge to the hosted server. Its tools come from the service (asked for when a client lists them, kept for five minutes), so they are always the current ones.
Claude Code:
claude mcp add barevalue -- npx -y barevalue-mcp
Or in any MCP client's configuration:
{
"mcpServers": {
"barevalue": {
"command": "npx",
"args": ["-y", "barevalue-mcp"]
}
}
}
Node 18 or later.
API key
If your email address has no Barevalue account yet, you do not need one to start. The agent calls barevalue_register with the address and gets a key in that one call, which this server keeps for the rest of the session. You get an email with a link: until you click it the account can edit 30 minutes, after it 10 hours a month.
If the address already has an account, barevalue_register is refused and you make the key yourself (Settings, API Keys on barevalue.com). Set it and the tools stop asking for one:
"env": { "BAREVALUE_API_KEY": "bv_sk_your_key_here" }
What to say
Edit the podcast episode at ~/recordings/ep42.wav with Barevalue. The show is "Tech Talk", the episode is "AI in 2026". Remove the sponsor read at the start.
The agent will:
- Upload the file (
barevalue_upload) - Order the edit (
barevalue_submit_url) - Check on it every minute or so until it is done (
barevalue_status), usually 5 to 15 minutes - Give you the download links, and the show notes and transcript as text (
barevalue_content) - Ask whether you are happy with it and pass that on (
barevalue_feedback), or have it edited again with your notes (barevalue_request_revision)
Tools
The list comes from the service, so tools/list is the authority. Today:
| Tool | What it does |
|---|---|
barevalue_register |
Create an account and get an API key in one call |
barevalue_upload |
Upload an audio file from this machine |
barevalue_submit_url |
Order editing, for an upload or for audio at a link |
barevalue_status |
Progress, time remaining, download links, what the edit changed |
barevalue_content |
Show notes, transcript and edit summary as text |
barevalue_feedback |
Say whether the edit was good |
barevalue_request_revision |
Have a finished order edited again with new instructions |
barevalue_updates |
Everything new on the account since the last call |
barevalue_list_orders |
Recent orders |
barevalue_account |
Minutes left this month and the pace limits |
barevalue_estimate |
Whether an order of a given length would be accepted |
barevalue_validate |
Pre-check audio at a link |
barevalue_pricing, barevalue_api_status |
Plans and current processing times |
Limits
- Audio only. One file per order, with one audio track, up to 60 minutes and 750 MB
- MP3, WAV, M4A, FLAC, AAC, OGG, Opus, WMA and AIFF
- The free plan edits one order at a time and 120 minutes in any 5 hours
- An uploaded file can be ordered once, within 2 hours of the upload
Changes in 1.4.0
- The tools now come from the hosted server.
barevalue_submit(withorder_id), the webhook tools and human editing are gone: the service retired them barevalue_uploaduses the new upload flow and returns anupload_idforbarevalue_submit_urlBAREVALUE_API_KEYis optionalBAREVALUE_API_URLis no longer read- With
BAREVALUE_API_KEYset, that key is the only one used: anapi_keypassed to a tool is ignored andbarevalue_registerdoes not replace it barevalue_uploadsends audio files only (by the real file's extension) and no call follows a redirect
Changes in 1.4.1
- A
BAREVALUE_API_KEYthat cannot be a key (empty quotes, two layers of quotes, a quote that is not closed) stops the server at startup with one line that says how to set it. Before, the first ran without a key and the others got a 401 on every call - When the service refuses the key in
BAREVALUE_API_KEY(revoked, expired, mistyped), the answer now says so and what to do: set a working key or remove the variable, then restart. That key is still the only one used. A key the session got frombarevalue_registerand that is later refused is dropped, so a working key can be passed asapi_key(registering the same address again is refused: it has an account by then) barevalue_uploadsends the file only to Barevalue's own storage host. Any other upload address is refused before a byte is sent- A long upload reports progress to a client that asks for it (a progress token on the call), about once a second
- Cancelling the call stops the upload, and so does the client going away. The same file asked for again reuses the upload it had been given, so retries do not use up the account's unordered uploads
- A second
barevalue_uploadcall for a file that is still on its way joins that upload and returns the sameupload_id, in place of sending the file twice - A streamed answer from the service is read correctly when it carries other messages or stays open after the answer
barevalue_uploadopens the file once and sends what it checked, so a file swapped in afterwards is not sent. A file with more than one name on disk (a hard link) is refused: copy it and upload the copy. A file the program may not read is refused in plain words
Changes in 1.4.2
- An upload no longer waits for ever when storage sends the start of an answer and then drops the connection. The call is answered with the reason, the file is closed, and the same file asked for again goes to the upload it had been given. An upload that goes quiet for 120 seconds is stopped the same way. A yes from storage that comes before the whole file was sent no longer counts as an upload
barevalue_submit_urlsends an idempotency key. An order that got no answer (a timeout, a broken connection) and is asked for again with the same arguments within 30 minutes goes out with the same key, so it is not placed twice. The timeout message says so. When the answer is that earlier order, it says so and what became of it. If it failed, the same call once more places a new order. If it is being edited or done, the same call keeps giving that order, and a second order of the same recording takes anidempotency_keyof your own. Anidempotency_keyyou pass yourself is sent as givenbarevalue_uploadlistsapi_keylike the other tools while the session has no key. It always took one- The texts about
barevalue_registerno longer promise a key to an address that already has an account: that call is refused, and the key comes from Settings, API Keys
Changes in 1.4.3
- The program is the same as 1.4.2. On the service's side, a file longer than 60 minutes is now refused before any editing and uses none of the allowance. Before, one could be accepted and fail part-way
- The package now names its repository,
barevalue-ai/barevalue-mcp, and this page leads with the hosted server and how to add it to each client - The repository is a Claude Code plugin and a Cursor plugin, and the skill names the second address,
https://barevalue.com/mcp/connect
Development
npm install
npm run build
node test-mcp.js # live read-only smoke test, then the local tests; no key needed
node test-mcp.js --offline # the local tests only, against a stub inside the test
BAREVALUE_API_KEY=... node test-mcp.js episode.mp3 # also uploads the file, places no order
Support
support@barevalue.com, the developer page or the API documentation, which is also plain markdown at https://barevalue.com/llms-full.txt.
License
MIT
Barevalue MCP questions
How do I add Barevalue MCP to Claude Code?
Run claude mcp add --env 'BAREVALUE_API_KEY=<YOUR_BAREVALUE_API_KEY>' barevalue-mcp -- npx -y barevalue-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Barevalue MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Barevalue MCP provide?
It exposes 12 tools, including barevalue_register, barevalue_upload, barevalue_submit_url, barevalue_status, barevalue_content.
How much does it cost to use Barevalue?
You get 10 free hours of editing per month with no payment details required.
Do I need an API key to start using the server?
No, the agent can call a registration tool to create an account and obtain a key in a single call.
What audio formats are supported?
The service supports MP3, WAV, M4A, FLAC, AAC, OGG, Opus, WMA, and AIFF.
What are the file size and length limits?
Orders are limited to one audio track per file, up to 60 minutes in length and 750 MB in size.