Barevalue edits podcast audio as a done-for-you service. An agent palms over one uncooked recording and will get again the completed episode, with noise and ranges mounted, filler phrases corresponding to um and uh trimmed and lengthy pauses and useless air eliminated, plus a transcript, present notes and spotlight clips. The agent doesn’t plan cuts or function an editor. It locations an order and collects the end result.
For brokers that is free. Orders positioned via MCP or the API are lined by an allowance of 600 minutes each 30 days, with no cost particulars and no approval step by an individual.
What the agent will get again
| Edited episode | MP3 at as much as 320 kbps. A lossless add (WAV, FLAC) additionally comes again lossless, with an MP3 beside it |
| Transcript | With each order |
| Present notes | Episodes of 10 minutes or longer |
| Spotlight clips | Episodes of 5 minutes or longer |
| Edit abstract | What the edit modified, the variety of cuts and the seconds eliminated |
| Obtain hyperlinks | Legitimate for twenty-four hours. A brand new standing name offers contemporary ones |
Present notes, transcript and edit abstract are additionally obtainable as plain textual content, so an agent can learn them with out downloading and parsing a file.
4 methods to attach
| Route | Tackle | Suits |
|---|---|---|
| Claude connector | Claude’s connector listing, or https://barevalue.com/mcp/join as a customized connector | Claude on the internet and desktop. The particular person indicators in to Barevalue as soon as |
| Hosted MCP | https://barevalue.com/mcp (streamable HTTP) | Claude Code, Cursor and any MCP shopper. No key wanted to attach |
| npm bridge | npx -y barevalue-mcp (stdio, Node 18 or later) | An area agent with a recording on disk |
| REST | https://barevalue.com/api/v1 | Code of your personal. OpenAPI at https://barevalue.com/api/v1/openapi.json |
All 4 attain the identical service and the identical allowance.
Claude connector. Barevalue is listed in Claude’s connector listing. Connecting opens a Barevalue sign-in, and the account’s e-mail tackle needs to be confirmed earlier than the connection may be authorised. On this door the particular person is already signed in, so there isn’t a register step and no API key within the dialog. Orders go by hyperlink.
Hosted MCP. One line in Claude Code:
claude mcp add --transport http barevalue https://barevalue.com/mcpIn Cursor, "barevalue": { "url": "https://barevalue.com/mcp" } underneath mcpServers in ~/.cursor/mcp.json. An agent with no account calls barevalue_register and will get a key in that one name. The opposite instruments take it as api_key or from an Authorization: Bearer header.
npm bridge. The hosted server takes recordings by hyperlink. For a file on disk its barevalue_upload instrument returns a curl command that sends the file. The npm package deal sends the file itself, so the agent passes solely a path:
claude mcp add barevalue -- npx -y barevalue-mcpThe package deal’s instruments come from the hosted server, in order that they match it. A key may be set in BAREVALUE_API_KEY or obtained via barevalue_register.
The order of calls
| Step | MCP instrument | REST |
|---|---|---|
| 1. Get a key (not on the connector door) | barevalue_register | POST /brokers/register |
| 2a. Stage a file with no hyperlink (non-obligatory) | barevalue_upload | POST /orders/upload-url, then a type POST of the file |
| 2b. Order the edit | barevalue_submit_url | POST /orders/submit |
| 3. Observe it | barevalue_status | GET /orders/{id} |
| 4. Learn the textual content | barevalue_content | GET /orders/{id}/content material |
| 5. Fee it | barevalue_feedback | POST /orders/{id}/suggestions |
| 6. Change it | barevalue_request_revision | POST /orders/{id}/revision |
The remaining instruments fill in round these. barevalue_updates (GET /updates) experiences every thing new on the account since a cursor, which saves watching an inbox. barevalue_account and barevalue_estimate present what’s left and whether or not an order of a given size is roofed. barevalue_validate pre-checks audio at a hyperlink with out ordering it. barevalue_pricing and barevalue_api_status want no key.
Step 1. barevalue_register takes e-mail (the tackle of the particular person the agent acts for) and optionally agent_name. It returns api_key (bv_sk_..., proven as soon as) and allowance. The important thing works directly. The tackle will get one e-mail asking its proprietor to substantiate it. Till then the account can edit half-hour and a couple of orders, and as soon as confirmed it has 600 minutes each 30 days. An tackle that already has an account will get registration_failed, and its proprietor makes a key on barevalue.com underneath Settings, API Keys.
Step 2. barevalue_submit_url takes podcast_name, episode_name and both file_url or upload_id. The hyperlink has to open the audio file itself with no login, not a share web page that reveals it. Non-compulsory fields are special_instructions (for instance “Take away the sponsor learn close to the beginning”), host_names, guest_names, episode_number and idempotency_key. The MCP instrument generates the idempotency key when it’s disregarded. REST requires one, a UUID that’s resent unchanged on a retry so no second order is created.
Step 3. The order is new whereas the file is fetched and measured, then submitted or in_progress_submitted whereas it’s edited, then performed or failed. Whereas it runs the standing carries progress.share, progress.estimated_seconds_remaining and retry_after_seconds. A test each 30 to 60 seconds is sufficient. A brief episode of as much as about quarter-hour usually finishes in about 5 to fifteen minutes. Longer information take longer, and a 60-minute file can take as much as about an hour. The standing response offers the estimate for every order.
Step 4. On performed the standing lists downloads (every with form: edited_audio, clip, show_notes, transcript), abstract and not_included, which names something the order doesn’t have and why. barevalue_content takes embody, a comma-separated alternative of abstract, show_notes and transcript. The transcript of a protracted episode is massive.
Steps 5 and 6. barevalue_feedback takes score (constructive or detrimental) with an non-obligatory remark and points. Our staff reads it. barevalue_request_revision takes directions (10 to 2,000 characters) and creates a brand new order from the unique recording. It makes use of the identical minutes as the unique. Each revision begins from the unique recording, so one request carries every thing that’s to be completely different, and a revision is requested on the unique order fairly than on an earlier revision.
Free allowance and limits
| Value | Free contained in the allowance. No cost particulars |
| Allowance | 600 minutes each 30 days. half-hour and a couple of orders till the e-mail tackle is confirmed |
| Tempo | One order edited at a time per account, and 120 minutes in any 5 hours |
| File | Audio solely. One file with one audio observe, 60 minutes or shorter, 750 MB or smaller |
| Codecs | MP3, WAV, M4A, FLAC, AAC, OGG, WMA and AIFF |
| Uploads | The add hyperlink works for quarter-hour. An add may be ordered as soon as, inside 2 hours |
| Minutes | Measured from the audio itself. They arrive again 30 days after the order that used them. An order turned away on the pre-check makes use of none |
The service edits spoken audio corresponding to podcasts and interviews. Music by itself is refused, and so is a file with a number of tracks. Separate host and visitor tracks should not accepted via the API or MCP.
When a name is refused
Each refusal has an error code and a message. A failed order has failure.code, a message written to move on to the person, retryable and next_action.
| Code | That means |
|---|---|
email_verification_required | The proprietor has not clicked the affirmation hyperlink, and the request wants it or is previous the half-hour |
too_many_orders_in_progress | An order is being edited. The subsequent is accepted when it’s performed |
window_limit_reached | 120 minutes ordered in 5 hours. retry_after says when extra can be found |
allowance_used | The 600 minutes are used for now |
servers_full | Busy. Nothing was created and nothing was counted. The identical request works after retry_after_seconds |
invalid_url | The hyperlink doesn’t result in a downloadable audio file |
upload_not_found | No add with that upload_id is ready on this account |
file_too_long | Over 60 minutes. Makes use of no minutes. Splitting the episode into components works |
content_not_recognized | Not sufficient speech to edit |
Labored instance
A whole order over the hosted MCP server, as JSON-RPC calls to https://barevalue.com/mcp (headers Content material-Sort: software/json and Settle for: software/json, textual content/event-stream). Responses are shortened.
1. Register.
{"jsonrpc": "2.0", "id": 1, "technique": "instruments/name", "params": {
"identify": "barevalue_register",
"arguments": {"e-mail": "host@instance.com", "agent_name": "Claude"}}}{"api_key": "bv_sk_...", "allowance": {"confirmed": false, "minutes_remaining": 30,
"orders_remaining": 2, "minutes_after_confirmation": 600}, "mcp_url": "https://barevalue.com/mcp"}2. Order.
{"jsonrpc": "2.0", "id": 2, "technique": "instruments/name", "params": {
"identify": "barevalue_submit_url",
"arguments": {
"api_key": "bv_sk_...",
"file_url": "https://instance.com/raw-episode-12.mp3",
"podcast_name": "The Lengthy Stroll",
"episode_name": "Episode 12",
"host_names": ["Dana"],
"special_instructions": "Take away the sponsor learn close to the beginning."}}}{"order_id": 21800, "standing": "queued",
"message": "File obtain queued. Order might be submitted routinely when obtain completes."}3. Observe. barevalue_status with {"api_key": "bv_sk_...", "order_id": 21800}, whereas it runs:
{"order_id": 21800, "standing": "in_progress_submitted",
"progress": {"share": 60, "estimated_seconds_remaining": 240}, "retry_after_seconds": 60}And as soon as it’s performed:
{"order_id": 21800, "standing": "performed",
"downloads": [
{"kind": "edited_audio", "format": "mp3", "url": "https://...", "expires_at": "..."},
{"kind": "transcript", "url": "https://..."},
{"kind": "show_notes", "url": "https://..."},
{"kind": "clip", "format": "mp3", "url": "https://..."}],
"abstract": {"modifications": ["Enhanced audio quality", "Trimmed awkward pauses",
"Cleaned up 3 moments"], "cuts": 18, "seconds_removed": 64.2},
"not_included": []}4. Learn the textual content. barevalue_content with {"api_key": "bv_sk_...", "order_id": 21800, "embody": "show_notes"}.
5. Fee it. barevalue_feedback with {"api_key": "bv_sk_...", "order_id": 21800, "score": "constructive"}.
The identical order over REST:
# 1. Key
curl -X POST https://barevalue.com/api/v1/brokers/register
-H "Content material-Sort: software/json"
-d '{"e-mail": "host@instance.com", "agent_name": "Claude"}'
# 2. Order
curl -X POST https://barevalue.com/api/v1/orders/submit
-H "Authorization: Bearer bv_sk_..." -H "Content material-Sort: software/json"
-d '{"file_url": "https://instance.com/raw-episode-12.mp3",
"podcast_name": "The Lengthy Stroll", "episode_name": "Episode 12",
"idempotency_key": "6f1c2b8e-3d4a-4f5b-9c7d-2e8a1b0c4d6f"}'
# 3. Observe, then acquire
curl -H "Authorization: Bearer bv_sk_..." https://barevalue.com/api/v1/orders/21800
curl -H "Authorization: Bearer bv_sk_..."
"https://barevalue.com/api/v1/orders/21800/content material?embody=show_notes,transcript"A file with no hyperlink provides one step earlier than the order. POST /orders/upload-url with {"filename": "episode-12.mp3"} returns an upload_id, an upload_url, upload_fields and a prepared curl command. The file goes up as a multipart type POST, each discipline in upload_fields first and the file final in a discipline named file. Storage solutions 204. The order then carries "upload_id" rather than "file_url".
As soon as the account’s e-mail tackle is confirmed, webhooks (POST /webhooks, occasions order.accomplished, order.failed and order.refunded) can substitute polling over REST.
