Barevalue MCP Server

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

Prerequisites

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:

• Sign up free at barevalue.com/register
• Or view plans at barevalue.com/pricing

Installation

Option 1: npx (Recommended)

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

Option 2: Global Install

npm install -g barevalue-mcp

Then configure Claude Code:

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

Configuration

Getting an API Key

1. Log in to your Barevalue account
2. Navigate to Settings → API Keys
3. Click Create API Key
4. Copy the key (starts with bv_sk_) — it's only shown once!

Claude Code Setup

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

Environment Variables

Available Tools

Account & Billing

`barevalue_account`

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

barevalue_account

`barevalue_estimate`

Calculate the cost of an order before submission.

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.

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.

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

`barevalue_submit`

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"

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.

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.

barevalue_status order_id=12345

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

`barevalue_list_orders`

List recent orders with pagination.

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!

barevalue_webhook_create \
  url="https://your-server.com/webhook" \
  events=["order.completed", "order.failed"]

**Available e