Barevalue

io.github.quietnotionPublished by GitHub account quietnotionv1.5.0Updated Oct 25, 2026

AI podcast editing. Sign up in one call, send audio by link or from disk, get an edited episode.

VerifiedStreamable HTTPWeb executableMedia & DesignAI & ML

Overview

AI-generated overview

Barevalue is an AI podcast editing service exposed as an MCP server: an assistant can upload or link a recording, order an edit, and fetch the finished audio…

What you can do
  • Register an account and get an API key in one call, or read account minutes, credit balance and limits
  • Check pricing, service health, queue times and estimate whether an edit of a given length is covered
  • Pre-check audio at a link and upload a local audio file to get an upload_id
  • Order an AI edit that removes noise, filler words and dead air and masters loudness, then poll progress and download links
  • Read show notes, speaker-labelled transcript and edit summary as text, and list recent orders or account updates
  • Rate a finished order or request a re-edit with new instructions
When to use it
Useful when you want an assistant to take a raw podcast or interview recording and return a cleaned, mastered episode with transcript and show notes, without operating an audio editor yourself. Suited to podcasters and anyone processing spoken-word audio on a recurring basis.
Requirements
Either the hosted endpoint (streamable HTTP, nothing to install) or the npm package barevalue-mcp over stdio, which needs Node 18 or later. An account is created by barevalue_register with an email address; an existing account needs a key in BAREVALUE_API_KEY. Network access to the service and its storage host. Audio only, one file per order, up to 60 minutes and 750 MB.
Before you install
Registering creates a real account tied to the email address given, and that person receives a verification link; until it is clicked the allowance is limited. Audio files are uploaded to Barevalue's storage and processed by a third-party service, so do not send confidential recordings without checking. Orders consume a free allowance or paid credit, and revisions create new orders. Feedback is passed to the vendor's team. A key in BAREVALUE_API_KEY is a secret and is the only key used once set.

Installation

In SourceWeft

  1. Open Barevalue in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.quietnotion%2Fbarevalue/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "barevalue": {
      "type": "http",
      "url": "https://barevalue.com/mcp"
    }
  }
}

README

Barevalue MCP server

[Barevalue]

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

ClientOne line
Claude Codeclaude 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
CursorAdd "barevalue": { "url": "https://barevalue.com/mcp" } under mcpServers in ~/.cursor/mcp.json
ChatGPTWith developer mode on, add a connector and paste https://barevalue.com/mcp/connect
Any agent that reads skillsnpx skills add barevalue-ai/barevalue-mcp
A file on your own diskclaude 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 haveUse
A recording that already has a linkThe 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:

bash
claude mcp add barevalue -- npx -y barevalue-mcp

Or in any MCP client's configuration:

json
{  "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:

json
"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:

  1. Upload the file (barevalue_upload)
  2. Order the edit (barevalue_submit_url)
  3. Check on it every minute or so until it is done (barevalue_status), usually 5 to 15 minutes
  4. Give you the download links, and the show notes and transcript as text (barevalue_content)
  5. 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:

ToolWhat it does
barevalue_registerCreate an account and get an API key in one call
barevalue_uploadUpload an audio file from this machine
barevalue_submit_urlOrder editing, for an upload or for audio at a link
barevalue_statusProgress, time remaining, download links, what the edit changed
barevalue_contentShow notes, transcript and edit summary as text
barevalue_feedbackSay whether the edit was good
barevalue_request_revisionHave a finished order edited again with new instructions
barevalue_updatesEverything new on the account since the last call
barevalue_list_ordersRecent orders
barevalue_accountMinutes left this month and the pace limits
barevalue_estimateWhether an order of a given length would be accepted
barevalue_validatePre-check audio at a link
barevalue_pricing, barevalue_api_statusPlans 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 (with order_id), the webhook tools and human editing are gone: the service retired them
  • barevalue_upload uses the new upload flow and returns an upload_id for barevalue_submit_url
  • BAREVALUE_API_KEY is optional
  • BAREVALUE_API_URL is no longer read
  • With BAREVALUE_API_KEY set, that key is the only one used: an api_key passed to a tool is ignored and barevalue_register does not replace it
  • barevalue_upload sends audio files only (by the real file's extension) and no call follows a redirect

Changes in 1.4.1

  • A BAREVALUE_API_KEY that 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 from barevalue_register and that is later refused is dropped, so a working key can be passed as api_key (registering the same address again is refused: it has an account by then)
  • barevalue_upload sends 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_upload call for a file that is still on its way joins that upload and returns the same upload_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_upload opens 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_url sends 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 an idempotency_key of your own. An idempotency_key you pass yourself is sent as given
  • barevalue_upload lists api_key like the other tools while the session has no key. It always took one
  • The texts about barevalue_register no 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

bash
npm installnpm run buildnode test-mcp.js                                   # live read-only smoke test, then the local tests; no key needednode test-mcp.js --offline                         # the local tests only, against a stub inside the testBAREVALUE_API_KEY=... node test-mcp.js episode.mp3 # also uploads the file, places no order

Support

[email protected], the developer page or the API documentation, which is also plain markdown at https://barevalue.com/llms-full.txt.

License

MIT

Source: README.md at commit 45be0bd

Tools

14

barevalue_register

Create account and API key

Creates a Barevalue account and returns a working API key in one call, with no password and no email click before the first order. The email is the address of the person the account is for, and that person receives a verification link. Until the link is clicked the account has a small free allowance ("allowance" in the result), and after it the full free monthly allowance. The returned api_key is what the other tools take as api_key. An address that already has an account gets no second key here (registration_failed): its owner makes one at barevalue.com, Settings, API Keys.

Parametersrefemailrequiredlast_nameagent_namefirst_name

barevalue_pricing

Pricing

What AI podcast editing costs and what it includes: the free monthly allowance, plans, supported audio formats, languages, length limits and features. No API key needed.

Takes no parameters.

barevalue_api_status

Service status

Service health, queue depth and expected processing times. No API key needed.

Takes no parameters.

barevalue_account

Account

Account details: the editing minutes left in the free monthly allowance, credit balance and any limits on the account.

Parametersapi_key

barevalue_estimate

Estimate an order

Reports what an AI podcast edit of a given length would use from the account and whether the account can cover it, before any order is placed. Nothing is charged.

Parametersapi_keyduration_minutesrequired

barevalue_validate

Pre-check an audio URL

Pre-checks a podcast or other audio recording at a URL without ordering an edit: confirms the link downloads, measures the length and checks that the file is speech and not music or silence. Nothing is charged.

Parametersapi_keyfile_urlrequired

barevalue_upload

Upload a local audio file

For a recording that is a file on the machine the agent runs on and has no link. Returns an upload_id and a ready curl command that sends the file from that machine (storage answers 204 when the upload worked). The upload_id is then accepted by barevalue_submit_url in place of file_url. One audio file, up to 750 MB and 60 minutes. The upload link works for 15 minutes and an upload can be ordered once. A recording that already has a direct link needs no upload: barevalue_submit_url takes the link itself.

Parametersapi_keyfilenamerequiredsize_bytes

barevalue_submit_url

Order editing

Edits a podcast episode or interview recording with AI and returns the finished audio. The edit removes background noise, hum and hiss, trims filler words such as um and uh, cuts long pauses and dead air, evens out the levels of the speakers and masters the loudness to -16 LUFS. Cuts or other changes can be asked for in special_instructions. Every order includes a transcript with speaker labels, and an episode of 10 minutes or more also gets show notes and short highlight clips for social media. It takes a recording in MP3, WAV, M4A, FLAC, AAC, OGG, WMA or AIFF, in any of 58 languages, and delivers MP3 at up to 320 kbps, with a WAV as well when the original is lossless. Audio only, one file with one audio track, up to 60 minutes. It edits the recording itself and creates no audio with AI: no translation or dubbing, no synthetic voices, no generated music or sound effects, no video. Free within the monthly allowance of the account. Returns an order_id. The order's progress and result are reported by barevalue_status. A file with no link is ordered with the upload_id that barevalue_upload returns, in place of file_url.

Parametersapi_keyfile_urlupload_idhost_namesguest_namesepisode_namerequiredpodcast_namerequiredepisode_numberidempotency_keyduration_minutesspecial_instructions

barevalue_status

Order status

Status of a podcast editing order. While processing it reports the current step, percentage and estimated seconds remaining. When status is "done" it lists each file with its kind (edited_audio, clip, show_notes, transcript and others) and a download URL valid for 24 hours, says what the edit changed, and says what is not included and why. When status is "failed" it gives the reason and what can be done next.

Parametersapi_keyorder_idrequired

barevalue_content

Show notes and transcript as text

The show notes, the full transcript with speaker labels and the edit summary of an edited podcast episode, as text, with no file to download and parse. Available once barevalue_status reports "done". The include parameter limits the answer to the parts named; the transcript of a long episode is large.

Parametersapi_keyincludeorder_idrequired

barevalue_feedback

Rate an edit

Records the user's rating of a finished order, positive or negative, with an optional comment and list of issues. Our team is told. A second rating for the same order replaces the first, comment included.

Parametersissuesratingrequiredapi_keycommentorder_idrequired

barevalue_request_revision

Ask for an edit to be changed

Re-edits a finished order with new instructions, for example "keep the story about the dog, it was cut" or "the intro music is too loud". It creates a new order from the original recording and returns its order_id. The progress and result of that order are reported by barevalue_status. It uses the same minutes from the allowance as the original order. Every revision is made from the original recording, so one request carries everything that is to be different. It returns the edited audio. The show notes and clips are made again only when the instructions ask for them.

Parametersapi_keyorder_idrequiredinstructionsrequired

barevalue_updates

What is new on the account

Everything that happened on the account since a given moment: an order was received, is ready, or failed and why, or the email address was confirmed. It carries what our emails say, so the user can follow an order without watching an inbox. The result includes a cursor, and a call that gives it back as since starts where this one ended. Without since it covers the last 24 hours. Each update has an id that never changes, so the same update can be recognised if it comes back on two consecutive calls.

Parameterssinceapi_key

barevalue_list_orders

List orders

Recent orders on the account with their status.

Parameterspagestatusapi_keyper_page

Version history

7
  1. v1.5.0LatestOct 14, 2026
  2. v1.4.3Oct 11, 2026
  3. v1.4.2Oct 9, 2026
  4. v1.4.1Oct 8, 2026
  5. v1.4.0Oct 7, 2026
  6. v1.3.0Oct 6, 2026
  7. v1.0.3Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.