barevalue_account
Get Barevalue account information including credit balance, AI subscription status, bonus minutes, and pricing. Use this to check available balance before submitting orders.
LABSCO SUMMARY
The tool descriptions say where money moves, which is unusual enough to be the reason to pick this over calling the API yourself.
barevalue_pricing and barevalue_api_status are marked as needing no authentication, barevalue_validate is marked as charging nothing, and barevalue_estimate exists so a duration is priced before a submission. The AI and human modes differ by more than rate: the AI path takes audio only and caps at 60 minutes, while the human path accepts video and bills per minute with a card covering the shortfall — an agent choosing between them on price alone would pick a mode the file cannot use. One operational detail sits in the webhook group: a signing secret is returned exactly once at creation, and rotating it stops the old secret immediately rather than overlapping.
What it is
An ordering server for Barevalue's podcast editing service: pricing and service health, credit balance and cost estimates, a local and a hosted upload path, AI or human editing, order polling, and webhook management.
What you get
- Quoting and health checks that need no authentication at all: barevalue_pricing returns tier minutes, monthly cost, overage rates, human editing rates, supported formats and capabilities, and barevalue_api_status returns service health, queue depth and estimated processing times.
- barevalue_account returns credit balance, AI subscription status and bonus minutes, and barevalue_estimate turns a duration_minutes into the split across bonus minutes, subscription minutes, credits and cash still owed.
- A path in for a local file and a path in for a hosted one: barevalue_upload takes a local file up to 750MB, handles the presigned S3 URL itself, and returns the order_id and s3_key that submission needs; barevalue_submit_url takes a public link on Dropbox, Google Drive or similar and downloads it.
- barevalue_validate pre-checks a file at a URL for speech content against a 10% minimum and detects music-only audio, and states that it charges no credits — its description marks it as unnecessary for files that came through barevalue_upload.
- barevalue_submit is where the service tier is chosen: editing_mode "ai" edits audio up to 60 minutes against credits or subscription minutes, and editing_mode "human" routes audio or video to a professional editor at per-minute rates, drawing credits first and charging the card on file for what remains.
- barevalue_status returns the processing state and, once finished, download URLs for the edited audio, a transcript as PDF, a transcript as DOCX and show notes; barevalue_list_orders pages recent orders by status.
- Webhook plumbing as its own group: barevalue_webhooks_list, barevalue_webhook_create for completion, failure and refund events, barevalue_webhook_update for the URL, events or is_active flag, barevalue_webhook_delete, and barevalue_webhook_rotate_secret.
Requirements
A Barevalue API key, supplied as BAREVALUE_API_KEY, plus credit or an AI subscription on the account for the calls that submit work. Human-mode submissions also draw on the default card on file once credits run out.
Setup effort
One command plus a key — npm install -g barevalue-mcp, then supply credentials
USE CASES
01
Quoting an episode before anyone commits money
Read the published rates, price the actual runtime against them, and check what the account can already cover from bonus minutes and credit.
02
Getting a recorded episode into the editing queue
Upload the file and let the server handle the presigned URL, submit it with the episode metadata, then poll until the edited audio and its transcripts are ready.
03
Submitting a file that already lives behind a share link
Screen the hosted file for speech before it costs anything, then hand the URL straight over instead of downloading and re-uploading it yourself.
04
Checking the service can take the work before a deadline
Read the queue depth and estimated turnaround before promising a date, and see where the orders already in flight have got to.
05
Wiring completion notices into your own system
Register an endpoint for completions, failures and refunds, keep the secret you are shown at creation, and cut over to a fresh one when it needs replacing.
15 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
barevalue_api_status
Check Barevalue API health, queue depth, and estimated processing times. Use this to verify the service is operational before submitting orders. No authentication required.
barevalue_estimate
Calculate the cost of an AI podcast editing order before submission. Returns breakdown of AI bonus minutes, subscription minutes, credits, and payment required.
barevalue_list_orders
List recent orders with their status. Useful for checking on multiple orders or finding a specific order.
barevalue_pricing
Get current Barevalue pricing for all subscription tiers and services. Returns AI editing tier details (minutes, monthly cost, overage rates), human editing rates, supported formats, and capabilities. No authentication required.
barevalue_status
Check the status of an order. Returns current processing state and, when complete, download URLs for edited audio, transcript PDF, transcript DOCX, and show notes.
barevalue_submit
Submit an uploaded file for editing. Two modes: editing_mode="ai" (default) does AI podcast editing of an audio file, billed against credits/subscription minutes (audio only, up to 60 min). editing_mode="human" routes to a professional human editor for audio OR video, billed at standard per-minute rates (credits first, then the default card on file is charged for the remainder); use this for white-label/human-only accounts and for video. Requires order_id and s3_key from barevalue_upload.
barevalue_submit_url
Submit a podcast for AI editing using a public URL. The file will be downloaded and processed. Useful for files hosted on Dropbox, Google Drive (with public link), or other file hosting services.
barevalue_upload
Upload an audio file for AI podcast editing. Handles getting a presigned S3 URL and uploading the file. Returns order_id and s3_key needed for submission. Maximum file size: 750MB.
barevalue_validate
Pre-check an audio file from a URL before submission. Validates speech content (minimum 10%) and detects music-only content. Does NOT charge credits. Use this for external URLs before submitting. Note: For files uploaded via barevalue_upload, validation is not needed - go directly to submit.
barevalue_webhook_create
Create a new webhook to receive notifications. Returns the webhook with its signing secret (shown only once - save it!).
barevalue_webhook_delete
Delete a webhook. This cannot be undone.
barevalue_webhook_rotate_secret
Generate a new signing secret for a webhook. The old secret will immediately stop working. Returns the new secret (shown only once).
barevalue_webhook_update
Update an existing webhook URL, events, or active status.
barevalue_webhooks_list
List all configured webhooks for your account. Webhooks send notifications when orders complete, fail, or are refunded.
BEFORE YOU INSTALL
What to know first
Tools you get
15 tools when we connected.
Requires
- npx on PATH
- BAREVALUE_API_KEY in your environment
Where it runs
Both documented setups run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 15 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g barevalue-mcpMCP Clients
Claude Code — npx
CLAUDE CODE — NPX · JSON
{
"mcpServers": {
"barevalue": {
"command": "npx",
"args": [
"-y",
"barevalue-mcp"
],
"env": {
"BAREVALUE_API_KEY": "<YOUR_BAREVALUE_API_KEY>"
}
}
}
}Claude Code — global install
CLAUDE CODE — GLOBAL INSTALL · JSON
{
"mcpServers": {
"barevalue": {
"command": "barevalue-mcp",
"env": {
"BAREVALUE_API_KEY": "<YOUR_BAREVALUE_API_KEY>"
}
}
}
}