Barevalue MCP server

Barevalue редактирует подкасты. Агент передаёт сервису исходную запись и получает готовый выпуск: с удалённым шумом и выровненной громкостью, без слов-паразитов и пауз, а также с расшифровкой, заметками к выпуску и фрагментами с яркими моментами для длинных записей.

Чтобы начать, достаточно одного вызова — вход в аккаунт не требуется. Каждый месяц доступны 10 часов бесплатного редактирования. Результат можно получить с битрейтом до 320 кбит/с или без потерь. Платёжные данные не нужны, и агенту не придётся работать в аудиоредакторе.

https://barevalue.com/mcp

Streamable HTTP: ничего устанавливать не нужно, ключ для подключения не требуется. Агент вызывает barevalue_register, передаёт адрес электронной почты и получает ключ в ответ на этот вызов.

Установка

Клиент	Одна команда
Claude Code	`claude mcp add --transport http barevalue https://barevalue.com/mcp`
Claude Code, с skill	`/plugin install barevalue --marketplace barevalue-ai/barevalue-mcp`
Claude (веб-версия и приложение для компьютера)	Откройте Settings, Connectors, Add custom connector и вставьте `https://barevalue.com/mcp/connect`
Cursor	Добавьте `"barevalue": { "url": "https://barevalue.com/mcp" }` в раздел `mcpServers` файла `~/.cursor/mcp.json`
ChatGPT	Включите режим разработчика, добавьте connector и вставьте `https://barevalue.com/mcp/connect`
Любой агент, который поддерживает skills	`npx skills add barevalue-ai/barevalue-mcp`
Файл на вашем компьютере	`claude mcp add barevalue -- npx -y barevalue-mcp` (npm-мост, описанный ниже)

У сервера есть два адреса. Адрес https://barevalue.com/mcp открыт: агент регистрируется самостоятельно и хранит собственный ключ. Адрес https://barevalue.com/mcp/connect сначала предлагает войти в аккаунт Barevalue в браузере. Именно такой адрес ожидают формы подключения в Claude и ChatGPT.

Для установки плагина в Claude Code требуется версия 2.1.275 или новее. В более ранней версии выполните команды claude plugin marketplace add barevalue-ai/barevalue-mcp, а затем claude plugin install barevalue@barevalue. Плагин добавляет размещённый сервер и skill skills/barevalue-podcast-editing, который объясняет агенту порядок вызовов и действия на случай отказа. Этот репозиторий также является плагином для Cursor (.cursor-plugin/plugin.json).

Для Cursor также доступна ссылка установки: cursor://anysphere.cursor-deeplink/mcp/install?name=barevalue&config=eyJ1cmwiOiJodHRwczovL2JhcmV2YWx1ZS5jb20vbWNwIn0=

npm-мост для записи на вашем компьютере

Размещённый сервер принимает запись по ссылке. Если файл находится на диске, сервер возвращает команду curl, которую должен выполнить агент. npm-пакет barevalue-mcp выполняет этот шаг самостоятельно: инструмент barevalue_upload принимает путь к файлу и отправляет его.

У вас есть	Используйте
Запись, для которой уже есть ссылка	Размещённый сервер: `https://barevalue.com/mcp`
Запись на этом компьютере (Claude Code, Cursor или любой локальный агент)	Подойдут оба варианта. С этим пакетом агенту не нужно запускать команды

Пакет служит мостом к размещённому серверу. Его инструменты предоставляет сервис: клиент запрашивает их при получении списка, а пакет хранит их пять минут. Поэтому список всегда актуален.

Claude Code:

claude mcp add barevalue -- npx -y barevalue-mcp

Или добавьте следующую конфигурацию в любой MCP-клиент:

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

Требуется Node 18 или новее.

API key

Если у вас ещё нет аккаунта Barevalue, он не нужен, чтобы начать работу. Агент вызывает barevalue_register, передаёт адрес электронной почты и получает ключ в ответ на этот вызов. Сервер хранит ключ до конца текущего сеанса. Вам придёт письмо со ссылкой: до перехода по ней аккаунт сможет редактировать записи в течение 30 минут, после подтверждения — 10 часов в месяц.

Если аккаунт с таким адресом уже существует, вызов barevalue_register будет отклонён. В этом случае создайте ключ самостоятельно: откройте Settings, API Keys на barevalue.com. Укажите ключ, и инструменты перестанут его запрашивать:

"env": { "BAREVALUE_API_KEY": "bv_sk_your_key_here" }

Что сказать агенту

Отредактируй выпуск подкаста из файла ~/recordings/ep42.wav с помощью Barevalue. Название шоу — "Tech Talk", название выпуска — "AI in 2026". Удали рекламный блок спонсора в начале.

Агент выполнит следующие действия:

Загрузит файл (barevalue_upload)
Закажет редактирование (barevalue_submit_url)
Будет примерно раз в минуту проверять статус, пока обработка не завершится (barevalue_status). Обычно это занимает от 5 до 15 минут
Передаст ссылки для скачивания, а также заметки к выпуску и расшифровку в виде текста (barevalue_content)
Спросит, устраивает ли вас результат, и передаст отзыв сервису (barevalue_feedback) или закажет повторное редактирование с учётом ваших замечаний (barevalue_request_revision)

Инструменты

Список инструментов предоставляет сервис, поэтому актуальный перечень можно получить через tools/list. Сейчас доступны:

Инструмент	Назначение
`barevalue_register`	Создать аккаунт и получить API key одним вызовом
`barevalue_upload`	Загрузить аудиофайл с этого компьютера
`barevalue_submit_url`	Заказать редактирование загруженного аудио или аудио по ссылке
`barevalue_status`	Проверить ход обработки, оставшееся время, ссылки для скачивания и узнать, что изменилось при редактировании
`barevalue_content`	Получить заметки к выпуску, расшифровку и краткое описание правок в виде текста
`barevalue_feedback`	Сообщить, понравился ли результат
`barevalue_request_revision`	Передать новые инструкции для повторного редактирования готового заказа
`barevalue_updates`	Получить все обновления аккаунта с момента последнего вызова
`barevalue_list_orders`	Просмотреть последние заказы
`barevalue_account`	Узнать, сколько минут осталось на этот месяц, и посмотреть ограничения по темпу обработки
`barevalue_estimate`	Проверить, будет ли принят заказ заданной продолжительности
`barevalue_validate`	Предварительно проверить аудио по ссылке
`barevalue_pricing`, `barevalue_api_status`	Посмотреть тарифы и текущие сроки обработки

Ограничения

Только аудио. Один аудиофайл на заказ, с одной аудиодорожкой; длительность — до 60 минут, размер — до 750 MB
Поддерживаемые форматы: MP3, WAV, M4A, FLAC, AAC, OGG, Opus, WMA и AIFF
Бесплатный тариф позволяет обрабатывать один заказ за раз и до 120 минут в течение любых 5 часов
Загруженный файл можно добавить в заказ один раз и только в течение 2 часов после загрузки

Изменения в версии 1.4.0

Теперь список инструментов поступает с размещённого сервера. Инструмент barevalue_submit с параметром order_id, инструменты для webhook и ручное редактирование удалены: сервис больше их не поддерживает
barevalue_upload использует новый процесс загрузки и возвращает upload_id для вызова barevalue_submit_url
BAREVALUE_API_KEY указывать необязательно
Параметр BAREVALUE_API_URL больше не считывается
Если задан BAREVALUE_API_KEY, используется только этот ключ: переданный инструменту параметр api_key игнорируется, а barevalue_register не заменяет его
barevalue_upload отправляет только аудиофайлы (тип определяется по фактическому расширению файла) и не следует перенаправлениям

Изменения в версии 1.4.1

Если значение BAREVALUE_API_KEY не может быть ключом (пустые кавычки, двойной слой кавычек или незакрытая кавычка), сервер останавливается при запуске и выводит одну строку с инструкцией по настройке. Раньше первый вызов выполнялся без ключа, а остальные каждый раз завершались ошибкой 401
Если сервис отклоняет ключ из BAREVALUE_API_KEY (например, он отозван, просрочен или введён с ошибкой), ответ теперь сообщает об этом и подсказывает, что делать: указать рабочий ключ или удалить переменную, а затем перезапустить сервер. По-прежнему используется только этот ключ. Если сервис позже отклонит ключ, полученный через barevalue_register в текущем сеансе, сервер удалит его, после чего можно передать рабочий ключ в параметре api_key. Повторная регистрация с тем же адресом будет отклонена: к этому моменту для него уже будет создан аккаунт
barevalue_upload отправляет файл только на собственный хост хранилища Barevalue. Любой другой адрес загрузки отклоняется до передачи первого байта
Если клиент запрашивает данные о ходе загрузки, передавая в вызове progress token, при длительной загрузке ему примерно раз в секунду отправляются обновления
Отмена вызова останавливает загрузку, как и отключение клиента. При повторном запросе того же файла используется уже созданная для него загрузка, поэтому повторные попытки не расходуют лимит незакреплённых за заказом загрузок аккаунта
Если второй вызов barevalue_upload поступает, пока файл ещё загружается, он подключается к этой загрузке и возвращает тот же upload_id, не отправляя файл повторно
Потоковый ответ сервиса теперь корректно считывается, даже если он содержит другие сообщения или соединение остаётся открытым после ответа
barevalue_upload открывает файл один раз и отправляет именно проверенный файл, поэтому подмена файла после проверки не приводит к отправке другого файла. Файл с несколькими именами на диске (жёсткая ссылка) отклоняется: скопируйте его и загрузите копию. Если программа не может прочитать файл, она сообщает об этом понятным текстом

Изменения в версии 1.4.2

Загрузка больше не зависает, если хранилище начинает отправлять ответ, а затем разрывает соединение. Вызов завершается с указанием причины, файл закрывается, а при повторной отправке того же файла запрос направляется к той же загрузке, к которой он был привязан изначально. Если загрузка не получает ответа в течение 120 секунд, она останавливается тем же способом. Подтверждение от хранилища, полученное до завершения отправки файла, больше не считается успешной загрузкой.
barevalue_submit_url отправляет ключ идемпотентности. Если на запрос о создании заказа не пришёл ответ из-за тайм-аута или разрыва соединения, повторный вызов с теми же аргументами в течение 30 минут отправляется с тем же ключом, поэтому заказ не создаётся дважды. В сообщении о тайм-ауте теперь указывается, что повторный вызов будет обработан таким образом. Если в ответ приходит информация о ранее созданном заказе, сообщается, что это прежний заказ, и приводится его статус. Если заказ завершился ошибкой, повторный вызов создаёт новый заказ. Если заказ редактируется или уже выполнен, повторный вызов возвращает информацию о нём. Чтобы создать второй заказ на ту же запись, укажите собственный idempotency_key. Переданный вами idempotency_key отправляется без изменений.
Пока в сессии нет ключа, barevalue_upload показывает параметр api_key, как и другие инструменты. Этот параметр требовался и раньше.
В описании barevalue_register больше не обещается отправка ключа на адрес, для которого уже существует учётная запись: такой вызов отклоняется. Ключ можно получить в Settings, API Keys.

Изменения в версии 1.4.3

Программа не изменилась по сравнению с версией 1.4.2. Теперь на стороне сервиса файлы длительностью более 60 минут отклоняются до начала редактирования и не расходуют доступный лимит. Раньше такой файл могли принять, но обработка могла завершиться ошибкой на полпути.
В пакет добавлена информация о репозитории barevalue-ai/barevalue-mcp. На этой странице теперь сначала описывается размещённый сервер и способы подключения к каждому клиенту.
Репозиторий доступен как плагин Claude Code и плагин Cursor. В skill указан второй адрес: https://barevalue.com/mcp/connect.

Разработка

npm install
npm run build
node test-mcp.js                                   # live read-only smoke test, then the local tests; no key needed
node test-mcp.js --offline                         # the local tests only, against a stub inside the test
BAREVALUE_API_KEY=... node test-mcp.js episode.mp3 # also uploads the file, places no order

Поддержка

служба поддержки, страница для разработчиков или документация API, также доступная в формате обычного markdown по адресу https://barevalue.com/llms-full.txt.

Лицензия

MIT