OpenRouter в MCP: каталог моделей, цены, бенчмарки, расходы ключа и completions в любом AI-агенте

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → OpenRouter, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

OpenRouter

OpenRouter, один API для сотен AI-моделей: поиск по каталогу моделей с ценами, провайдерами, бенчмарками и рейтингами, проверка расходов ключа, просмотр прошлых генераций и отправка chat completions, эмбеддингов и запросов изображений любой модели.

Настройка

Настройка занимает около 2 минут. Нужна учётная запись OpenRouter.

1. Войдите на https://openrouter.ai и пополните баланс в Settings, Credits. Бесплатные модели :free работают без кредитов в пределах дневных лимитов.
2. Откройте Settings, API Keys (https://openrouter.ai/settings/keys), нажмите Create Key, задайте имя и, настоятельно рекомендуется, credit limit: ключ может тратить баланс аккаунта до этого лимита.
3. Вставьте ключ, начинающийся с sk-or-v1-, в OPENROUTER_API_KEY. Он отправляется как Authorization: Bearer. Ключ управления (management key) здесь не подходит. Запросы несут заголовки HTTP-Referer и X-OpenRouter-Title, которые указывают AnythingMCP как вызывающее приложение в OpenRouter.
4. Установите коннектор и запустите openrouter_get_current_key, чтобы проверить ключ.

Что он читает (бесплатно):

• Каталог моделей через openrouter_list_models: id моделей, длина контекста, цены, модальности ввода и вывода, поддерживаемые параметры и поддержка reasoning, с фильтрами вроде q, category, supported_parameters=tools, max_price и context и сортировкой на сервере, например sort=pricing-low-to-high. openrouter_list_user_models показывает модели, которые этот ключ действительно может использовать с учётом предпочтений по провайдерам, настроек приватности и guardrails аккаунта.
• Одну модель через openrouter_get_model, эндпоинты провайдеров, которые её обслуживают, через openrouter_list_model_endpoints (цена, лимиты контекста и вывода, квантизация, статус, аптайм, задержка и пропускная способность за последние 30 минут) и openrouter_list_providers для слагов провайдеров, штаб-квартиры, стран дата-центров и ссылок на их политики.
• Качество и популярность: openrouter_list_benchmarks (Artificial Analysis, Design Arena и собственные оценки OpenRouter) и openrouter_get_model_rankings (топ-50 моделей по токенам за день, неделю или месяц, данные с 2025-01-01).
• Расходы: openrouter_get_current_key показывает лимит ключа, limit_remaining, расход за сегодня, эту неделю, этот месяц и всего, бюджеты и статус бесплатного уровня. openrouter_get_generation даёт точную стоимость, токены, задержку и провайдера одного вызова (его id это id completion, он может появиться через несколько секунд), а openrouter_get_generation_content сохранённые промпт и ответ, если включено логирование промптов.

Что стоит денег: openrouter_chat_completion (с model и messages; models добавляет запасные модели, provider управляет маршрутизацией по порядку, only, цене или пропускной способности, data_collection: deny или zdr, response_format запрашивает JSON, reasoning задаёт усилие), openrouter_create_embeddings и openrouter_generate_image (возвращаются как изображения). Они оплачиваются со счёта аккаунта, если не используется модель :free. Все инструменты включены при установке, поэтому ИИ подтверждает модель и цель перед крупными или повторными вызовами и задаёт max_completion_tokens, чтобы ограничить ответ.

Форматы данных: id моделей имеют вид author/slug (openai/gpt-4o), варианты: :free (бесплатно, с лимитом), :online (веб-поиск), :nitro (самый быстрый провайдер), :floor (самый дешёвый) и :thinking. Цены в каталоге это строки в USD за токен ("0.0000025" равно 2,50 USD за миллион токенов); request и image указаны за запрос или за изображение. Фильтры max_price и max_price маршрутизации принимают USD за миллион токенов. Стоимость и расход в ответах о ключе и генерациях указаны в USD. Completion возвращает choices[0].message.content, finish_reason (stop, length при достижении лимита токенов, tool_calls, content_filter), usage с числом токенов и cost, а также provider. created в секундах Unix; даты в UTC.

Постраничный вывод: инструменты списка моделей по умолчанию возвращают 50 моделей; ИИ передаёт offset 50, 100 и так далее с тем же limit, пока страница не вернётся короче, и предпочитает фильтры и sort чтению всего каталога.

Ограничения: модели :free допускают 20 запросов в минуту и 50 в день, или 1 000 в день, если когда-либо было куплено кредитов на 10 USD. Платные модели ограничены балансом аккаунта, credit limit ключа и бюджетами, заданными администратором организации. Бенчмарки допускают 30 запросов в минуту на ключ.

Частые ошибки: 401 означает недействительный или отключённый ключ. 402 значит, что кредитов не хватает или лимит ключа исчерпан (error.metadata.limit_source укажет, какой; пополните баланс или поднимите лимит). 403 это блокировка guardrail или модерацией, 404 неизвестная модель или генерация, 408 тайм-аут, 429 лимит запросов (подождите или используйте платный вариант), 502 сбой у провайдера модели, 503 нет провайдера, отвечающего требованиям маршрутизации (ослабьте provider). Ошибка провайдера во время генерации может прийти с HTTP 200 и объектом error; она сообщается как неудачный вызов.

Коннектор не показывает баланс всего аккаунта, отчёты об активности и аналитику и не управляет ключами, потому что для этого нужен отдельный ключ управления. Стриминг, устаревший эндпоинт text completions, пакетная обработка, видео и аудио тоже не доступны.

Предварительные требования: OPENROUTER_API_KEY

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите OpenRouter и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Какие модели с вызовом инструментов и контекстом от 128K стоят меньше 1 USD за миллион входных токенов?»
• «Сравни провайдеров, обслуживающих deepseek/deepseek-chat, по цене, аптайму и пропускной способности.»
• «Сколько этот API-ключ потратил в этом месяце и сколько осталось от его лимита?»
• «Попроси google/gemini-2.5-flash кратко изложить этот текст в пяти пунктах, не больше 500 выходных токенов.»
• «Какие модели в топ-10 по токенам на этой неделе и как они показывают себя в бенчмарках по программированию?»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT