Labsco
quietnotion logo

Barevalue MCP

★ 1

from quietnotion

AI podcast editing as a service. Upload raw audio or submit a URL, get back edited episodes with filler words removed, noise reduction, transcripts, show notes, and social clips. Includes webhooks for automation.

🔥🔥🔥✓ VerifiedPaid serviceNeeds API keys
#email#automation#social-media#payments#documents#git#security

barevalue-mcp

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.

Features

  • 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-validate URLs before submission to catch issues early

Available Tools

Account & Billing

barevalue_account

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

Copy & paste — that's it
barevalue_account

barevalue_estimate

Calculate the cost of an order before submission.

Copy & paste — that's it
barevalue_estimate duration_minutes=45

Order Workflow

barevalue_upload

Upload an audio file from your local machine. Returns order_id and s3_key for submission.

Copy & paste — that's it
barevalue_upload file_path="/path/to/episode.mp3"

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

barevalue_validate

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 via barevalue_upload don't need validation - go directly to barevalue_submit.

Copy & paste — that's it
barevalue_validate file_url="https://example.com/episode.mp3"

barevalue_submit

Submit an uploaded file for AI editing. Charges credits/subscription minutes.

Copy & paste — that's it
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 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

barevalue_submit_url

Submit using a public URL instead of uploading.

Copy & paste — that's it
barevalue_submit_url \
  file_url="https://example.com/episode.mp3" \
  podcast_name="My Podcast" \
  episode_name="Episode 42"

barevalue_status

Check order status. Returns download URLs when complete.

Copy & paste — that's it
barevalue_status order_id=12345

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

barevalue_list_orders

List recent orders with pagination.

Copy & paste — that's it
barevalue_list_orders page=1 per_page=20 status="completed"

Webhooks

barevalue_webhooks_list

List all configured webhooks.

barevalue_webhook_create

Create a webhook. Save the secret — it's only shown once!

Copy & paste — that's it
barevalue_webhook_create \
  url="https://your-server.com/webhook" \
  events=["order.completed", "order.failed"]

Available events: order.completed, order.failed, order.refunded

barevalue_webhook_update

Update webhook URL, events, or active status.

Copy & paste — that's it
barevalue_webhook_update webhook_id=1 is_active=false

barevalue_webhook_delete

Delete a webhook permanently.

Copy & paste — that's it
barevalue_webhook_delete webhook_id=1

barevalue_webhook_rotate_secret

Generate a new signing secret. Old secret stops working immediately.

Copy & paste — that's it
barevalue_webhook_rotate_secret webhook_id=1

Error Handling

The server returns structured errors:

Copy & paste — that's it
{
  "error": "insufficient_credits",
  "message": "Not enough credits. Need $3.15, have $2.00",
  "statusCode": 402
}

Common errors:

ErrorMeaning
invalid_api_keyAPI key is missing, invalid, or revoked
insufficient_creditsNot enough credits or subscription minutes
validation_failedFile failed pre-checks (not enough speech, music detected)
file_too_largeFile exceeds 750MB limit
rate_limitedToo many requests (limit: 10/minute)

Pricing

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:

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

Use barevalue_estimate to check your available minutes before submitting. View plans at barevalue.com/pricing.

Rate Limits

  • 10 requests per minute per API key
  • File uploads have a 5-minute timeout
  • Order processing typically completes in 10-30 minutes

Security

  • API keys are transmitted via environment variable, never hardcoded
  • All API communication uses HTTPS
  • Webhook signatures use HMAC-SHA256 for verification
  • Presigned S3 URLs expire after 30 minutes

Development

Copy & paste — that's it
# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

Support

License

MIT