MCP (Model Context Protocol) server for the Barevalue AI podcast editing API. Allows Claude Code and other MCP-compatible tools to submit and manage podcast editing orders programmatically. - Upload audio files directly from your local machine - Submit orders for AI-powered podcast editing - Check order status and download completed files - Manage webhooks for automated notifications - Pre-validat
Add this skill
npx mdskills install quietnotion/barevalue-mcpComprehensive MCP server with well-documented tools for podcast editing workflow and strong examples
MCP (Model Context Protocol) server for the Barevalue AI podcast editing API. Allows Claude Code and other MCP-compatible tools to submit and manage podcast editing orders programmatically.
You need a Barevalue account to submit orders via MCP. The Basic plan is free and includes minutes and orders each month. Paid plans (Starter, Creator, Pro) include more minutes, more orders, and additional features.
Orders use your subscription minutes. If your account has insufficient minutes, submission will fail with insufficient_credits error.
To get started:
No installation required. Configure Claude Code to run via npx:
{
"mcpServers": {
"barevalue": {
"command": "npx",
"args": ["-y", "barevalue-mcp"],
"env": {
"BAREVALUE_API_KEY": "bv_sk_your_api_key_here"
}
}
}
}
npm install -g barevalue-mcp
Then configure Claude Code:
{
"mcpServers": {
"barevalue": {
"command": "barevalue-mcp",
"env": {
"BAREVALUE_API_KEY": "bv_sk_your_api_key_here"
}
}
}
}
bv_sk_) — it's only shown once!Add to your Claude Code settings file (~/.claude/settings.json):
{
"mcpServers": {
"barevalue": {
"command": "npx",
"args": ["-y", "barevalue-mcp"],
"env": {
"BAREVALUE_API_KEY": "bv_sk_your_api_key_here"
}
}
}
}
| Variable | Required | Description |
|---|---|---|
BAREVALUE_API_KEY | Yes | Your Barevalue API key (starts with bv_sk_) |
BAREVALUE_API_URL | No | Override API base URL (default: https://barevalue.com/api/v1) |
barevalue_accountGet account information including credit balance, AI subscription status, and pricing.
barevalue_account
barevalue_estimateCalculate the cost of an order before submission.
barevalue_estimate duration_minutes=45
barevalue_uploadUpload an audio file from your local machine. Returns order_id and s3_key for submission.
barevalue_upload file_path="/path/to/episode.mp3"
Supported formats: mp3, wav, m4a, flac, aac, ogg Maximum file size: 750MB
barevalue_validatePre-check a file from a public URL before submission. Validates speech content (minimum 10%) and detects music-only content. Does NOT charge credits.
Note: This is for external URLs only. Files uploaded via barevalue_upload don't need validation - go directly to barevalue_submit.
barevalue_validate file_url="https://example.com/episode.mp3"
barevalue_submitSubmit an uploaded file for AI editing. Charges credits/subscription minutes.
barevalue_submit \
order_id=12345 \
s3_key="123/12345/raw/episode.mp3" \
podcast_name="My Podcast" \
episode_name="Episode 42: The Answer" \
processing_style="standard"
Optional parameters:
episode_number - Episode number for organizationspecial_instructions - Custom editing instructions (max 2000 chars)processing_style - standard | minimal | aggressivehost_names - Array of host names for transcript speaker labelsguest_names - Array of guest names for transcript speaker labelsbarevalue_submit_urlSubmit using a public URL instead of uploading.
barevalue_submit_url \
file_url="https://example.com/episode.mp3" \
podcast_name="My Podcast" \
episode_name="Episode 42"
barevalue_statusCheck order status. Returns download URLs when complete.
barevalue_status order_id=12345
Statuses: pending, downloading, processing, transcribing, editing, completed, failed, refunded
barevalue_list_ordersList recent orders with pagination.
barevalue_list_orders page=1 per_page=20 status="completed"
barevalue_webhooks_listList all configured webhooks.
barevalue_webhook_createCreate a webhook. Save the secret — it's only shown once!
barevalue_webhook_create \
url="https://your-server.com/webhook" \
events=["order.completed", "order.failed"]
Available events: order.completed, order.failed, order.refunded
barevalue_webhook_updateUpdate webhook URL, events, or active status.
barevalue_webhook_update webhook_id=1 is_active=false
barevalue_webhook_deleteDelete a webhook permanently.
barevalue_webhook_delete webhook_id=1
barevalue_webhook_rotate_secretGenerate a new signing secret. Old secret stops working immediately.
barevalue_webhook_rotate_secret webhook_id=1
Here's a typical workflow for uploading a local file:
User: Upload and edit my podcast episode at /Users/me/recording.mp3
Claude: I'll help you submit that podcast episode for editing.
1. First, let me check your account balance...
[calls barevalue_account]
You have 120 AI minutes remaining on your subscription.
2. Uploading the file...
[calls barevalue_upload file_path="/Users/me/recording.mp3"]
Upload complete. Order ID: 12345
3. Submitting for editing...
[calls barevalue_submit order_id=12345 s3_key="..." podcast_name="My Show" episode_name="Episode 1"]
Order submitted! Estimated completion: 15 minutes.
4. I'll check the status...
[calls barevalue_status order_id=12345]
Status: completed
Download links:
- Edited audio: https://...
- Transcript PDF: https://...
- Show notes: https://...
For files already hosted online, you can validate before submitting:
User: Edit this podcast: https://example.com/episode.mp3
Claude: I'll validate and submit that for editing.
1. Checking your account...
[calls barevalue_account]
You have 50 AI bonus minutes available.
2. Validating the file...
[calls barevalue_validate file_url="https://example.com/episode.mp3"]
✓ Speech detected: 87%
✓ No music-only content detected
Duration: 32 minutes
3. Submitting for editing...
[calls barevalue_submit_url file_url="..." podcast_name="My Show" episode_name="Episode 5"]
Order submitted! Order ID: 12346
User: What's the status of my recent orders?
Claude: [calls barevalue_list_orders per_page=5]
Here are your recent orders:
| Order ID | Episode | Status | Created |
|----------|---------|--------|---------|
| 12345 | Episode 42 | completed | 2 hours ago |
| 12344 | Episode 41 | completed | yesterday |
| 12343 | Episode 40 | processing | just now |
The server returns structured errors:
{
"error": "insufficient_credits",
"message": "Not enough credits. Need $3.15, have $2.00",
"statusCode": 402
}
Common errors:
| Error | Meaning |
|---|---|
invalid_api_key | API key is missing, invalid, or revoked |
insufficient_credits | Not enough credits or subscription minutes |
validation_failed | File failed pre-checks (not enough speech, music detected) |
file_too_large | File exceeds 750MB limit |
rate_limited | Too many requests (limit: 10/minute) |
MCP orders use your subscription minutes — the same balance you'd use on barevalue.com. The Basic plan is free and includes minutes and orders each month. Paid plans include more minutes, orders, and features.
What's included with every order:
Use barevalue_estimate to check your available minutes before submitting. View plans at barevalue.com/pricing.
# Install dependencies
npm install
# Build
npm run build
# Watch mode
npm run dev
MIT
Install via CLI
npx mdskills install quietnotion/barevalue-mcpBarevalue MCP is a free, open-source AI agent skill. MCP (Model Context Protocol) server for the Barevalue AI podcast editing API. Allows Claude Code and other MCP-compatible tools to submit and manage podcast editing orders programmatically. - Upload audio files directly from your local machine - Submit orders for AI-powered podcast editing - Check order status and download completed files - Manage webhooks for automated notifications - Pre-validat
Install Barevalue MCP with a single command:
npx mdskills install quietnotion/barevalue-mcpThis downloads the skill files into your project and your AI agent picks them up automatically.
Barevalue MCP works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.