Barevalue MCP

MCP (Model Context Protocol) server for theBarevalueAI podcast editing API. Allows Claude Code and other MCP-compatible tools to submit and manage podcast editing orders programmatically.

- Sign up free atbarevalue.com/register
- Or view plans atbarevalue.com/pricing

{ "mcpServers": { "barevalue": { "command": "npx", "args": ["-y", "barevalue-mcp"], "env": { "BAREVALUE_API_KEY": "bv_sk_your_api_key_here" } } } }

{ "mcpServers": { "barevalue": { "command": "barevalue-mcp", "env": { "BAREVALUE_API_KEY": "bv_sk_your_api_key_here" } } } }

- Log in to yourBarevalue account
- Navigate toSettings→API Keys
- ClickCreate API Key
- Copy the key (starts withbv_sk_) — it's only shown once!

{ "mcpServers": { "barevalue": { "command": "npx", "args": ["-y", "barevalue-mcp"], "env": { "BAREVALUE_API_KEY": "bv_sk_your_api_key_here" } } } }

Get account information including credit balance, AI subscription status, and pricing.

Calculate the cost of an order before submission.

Upload an audio file from your local machine. Returnsorder_idands3_keyfor submission.

barevalue_upload file_path="/path/to/episode.mp3"

Supported formats:mp3, wav, m4a, flac, aac, oggMaximum file size:750MB

Pre-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 viabarevalue_uploaddon't need validation - go directly tobarevalue_submit.

barevalue_validate file_url="https://example.com/episode.mp3"

Submit 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"

- episode_number- Episode number for organization
- special_instructions- Custom editing instructions (max 2000 chars)
- processing_style-standard|minimal|aggressive
- host_names- Array of host names for transcript speaker labels
- guest_names- Array of guest names for transcript speaker labels

Submit 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"

Check order status. Returns download URLs when complete.

Statuses:pending,downloading,processing,transcribing,editing,completed,failed,refunded

barevalue_list_orders page=1 per_page=20 status="completed"

Create 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

Update webhook URL, events, or active status.

barevalue_webhook_update webhook_id=1 is_active=false

Generate 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 |

{ "error": "insufficient_credits", "message": "Not enough credits. Need $3.15, have $2.00", "statusCode": 402 }

MCP orders use your subscription minutes — the same balance you'd use on barevalue.com. TheBasic plan is freeand includes minutes and orders each month. Paid plans include more minutes, orders, and features.

- Edited audio file (filler words, long pauses, false starts removed)
- Transcript (PDF and DOCX)
- Show notes with timestamps
- Social media clips (AI-selected highlights)

Usebarevalue_estimateto check your available minutes before submitting. View plans atbarevalue.com/pricing.

# Install dependencies npm install # Build npm run build # Watch mode npm run dev

- Documentation:https://barevalue.com/docs/api-v1
- Email:support@barevalue.com

MCP-native AI media generation with x402 pay-per-call. Image, video, audio, and music from 6 providers — composable via resource IDs. USDC on Base.