Каталог MCP
benswel/qr-agent-core

benswel/qr-agent-core

Name: benswel/qr-agent-core
Availability: InStock
Author: benswel

MCP-сервер для управления динамическими QR-кодами через API и AI-агентов. QR-as-a-Service с аналитикой, вебхуками, UTM-метками и 37 инструментами для Claude, Cursor. Подходит маркетологам и разрабо...

Github NPM Сайт сервера

README

37 инструментов

Версии

Установить сервер

QR for Agent

QR-as-a-Service API built for AI agents. Create, update, and track dynamic QR codes programmatically via REST API or MCP (37 tools).

QR codes point to short URLs (/r/:shortId) that you can retarget at any time — the QR image never changes, but scanning it goes to the new destination. Multi-tenant by design, with full scan analytics.

Live API: api.qrforagent.com | Site: qrforagent.com | MCP: qr-for-agent

Features

Dynamic QR codes — change the destination URL without regenerating the image
11 QR types — URL, vCard, WiFi, Email, SMS, Phone, Event, Text, Location, Social, App Store
Custom styling — dot shapes (square, rounded, dots, classy-rounded), corner styles, colors, gradients, logo embedding, frames with CTA text
SVG & PNG — vector and bitmap output
Enriched analytics — device type, browser, OS, country, city, referrer, scans-by-day
Real-time webhooks — HMAC-SHA256 signed payloads with delivery logging
UTM tracking — auto-append UTM parameters to redirect URLs
GTM support — intermediate page with Google Tag Manager snippets
Conditional redirects — route by device, OS, country, language, time range, or A/B split
Custom domains — Pro users brand short URLs with their own domain (qr.yourbrand.com/r/abc123)
Expiration & scheduling — auto-expire QR codes or schedule URL swaps
Conversion tracking — tracking pixel + API for post-scan events (purchases, signups) with ROI analytics
Frames & templates — decorative frames around QR codes (banner_top, banner_bottom, rounded) with CTA text
Bulk operations — create, update, or delete up to 50 QR codes per request, or up to 500 via CSV upload (Pro)
Multi-tenant — each API key sees only its own data
MCP server — qr-for-agent with 37 tools for Claude Desktop, Cursor, etc.
Plan-based quotas — Free (10 QR, 1K scans/month) and Pro ($19/month, unlimited)
Self-service registration — POST /api/register with email, no credit card
Stripe integration — checkout, billing portal, webhook-driven plan management
OpenAPI docs — Swagger UI at /documentation
AI-discoverable — /.well-known/ai-plugin.json and /.well-known/mcp.json
Open source — MIT license, self-hostable via Docker

Инструменты были проиндексированы: 21.10.2026

bulk_create_from_csv

Создаёт до 500 QR-кодов из данных CSV. Требуется Pro-план. Отправьте содержимое CSV в виде строки. Обязательная колонка: target_url. Необязательные колонки: label, format, type, foreground_color, background_color, dot_style, corner_style, frame_style, frame_text, expires_at. Возвращает все созданные QR-коды.

Параметры

csv_contentstringобязательный
Содержимое CSV в виде строки со строкой заголовка. Пример: "target_url,label\nhttps://example.com,My QR\nhttps://other.com,Other QR"

bulk_create_qr_codes

Создаёт несколько QR-кодов в одном запросе (до 50). Каждый элемент поддерживает те же опции, что и create_qr_code. Проверка квоты работает по принципу «всё или ничего»: если пакет превысит лимит вашего плана, QR-коды не создаются. Идеально подходит для создания QR-кодов для каталогов продуктов, списков событий или пакетных операций.

Параметры

itemsobject[]обязательный
Массив QR-кодов для создания. Максимум 50 за запрос.

bulk_delete_qr_codes

Удаляет несколько QR-кодов и их аналитику сканирований в одном запросе (до 50). Элементы с несуществующим short_id помечаются как not_found, но это не приводит к сбою всего пакета.

Параметры

short_idsstring[]обязательный
Массив строк short_id для удаления. Максимум 50 на запрос.

bulk_update_qr_codes

Обновить несколько QR-кодов одним запросом (до 50). Изменить целевые URL и/или метки. Элементы с несуществующим short_id отмечаются как not_found, но не прерывают весь пакет.

Параметры

itemsobject[]обязательный
Массив обновлений QR-кодов. Максимум 50 на запрос.

create_app_store_qr

Создайте QR-код, который перенаправляет в правильный магазин приложений в зависимости от устройства. iPhone — в App Store, Android — в Google Play, другие устройства — на запасной URL. Укажите хотя бы один URL магазина.

Параметры

android_urlstring
URL магазина Google Play.
background_colorstring
Шестнадцатеричный цвет фона.
corner_styleenum
Форма угла.
dot_styleenum
Форма точки.
fallback_urlstring
Резервный URL для немобильных устройств.
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
ios_urlstring
URL-адрес Apple App Store.
labelstring
Я не вижу QR-код в нашем диалоге. Пожалуйста, прикрепите изображение QR-кода или укажите, какая информация в нём закодирована (например, ссылка, текст, контактные данные), и я помогу подобрать подпись.
logo_urlstring
URL логотипа или data URI.

create_email_qr

Создайте QR-код, который при сканировании открывает заранее заполненное письмо. Можно заранее задать получателя, тему, текст, копию (CC) и скрытую копию (BCC).

Параметры

background_colorstring
Шестнадцатеричный цвет фона.
bccstring
Получатели скрытой копии.
bodystring
Текст тела электронного письма.
ccstring
Получатели копии
corner_styleenum
Форма угла.
dot_styleenum
Форма точки.
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
labelstring
Я не вижу QR-код в нашем диалоге. Пожалуйста, прикрепите изображение QR-кода или укажите, какая информация в нём закодирована (например, ссылка, текст, контактные данные), и я помогу подобрать подпись.
logo_urlstring
URL логотипа или data URI.
subjectstring
Тема письма
tostringобязательный
Адрес email получателя.

create_event_qr

Создаёт QR-код, который добавляет событие календаря при сканировании. Кодирует стандартный iCalendar VEVENT, который могут импортировать приложения-календари.

Параметры

background_colorstring
Шестнадцатеричный цвет фона.
corner_styleenum
Форма угла.
descriptionstring
Описание события.
dot_styleenum
Форма точки.
endstringобязательный
Дата и время окончания события в формате ISO 8601.
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
labelstring
Я не вижу QR-код в нашем диалоге. Пожалуйста, прикрепите изображение QR-кода или укажите, какая информация в нём закодирована (например, ссылка, текст, контактные данные), и я помогу подобрать подпись.
locationstring
Место проведения мероприятия.
logo_urlstring
URL логотипа или data URI.
startstringобязательный
Дата и время начала события в формате ISO 8601 (например, 2026-03-15T09:00:00Z).
summarystringобязательный
Название и краткое описание события.

create_location_qr

Создает QR-код, который открывает местоположение на карте при сканировании. Кодирует географические координаты, которые картографические приложения могут распознавать.

Параметры

background_colorstring
Шестнадцатеричный цвет фона.
corner_styleenum
Форма угла.
dot_styleenum
Форма точки.
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
labelstring
Человекочитаемое название места (отображается на карте).
latitudenumberобязательный
Географическая широта (от -90 до 90).
logo_urlstring
URL логотипа или data URI.
longitudenumberобязательный
Географическая долгота (от -180 до 180).
qr_labelstring
Метка для этого QR-кода (внутренняя).

create_phone_qr

Создайте QR-код, который при сканировании инициирует телефонный звонок. Номер телефона кодируется непосредственно в QR-коде.

Параметры

background_colorstring
Шестнадцатеричный цвет фона.
corner_styleenum
Форма угла.
dot_styleenum
Форма точки.
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
labelstring
Я не вижу QR-код в нашем диалоге. Пожалуйста, прикрепите изображение QR-кода или укажите, какая информация в нём закодирована (например, ссылка, текст, контактные данные), и я помогу подобрать подпись.
logo_urlstring
URL логотипа или data URI.
phone_numberstringобязательный
Номер телефона для звонка.

create_qr_code

Создаёт новый управляемый QR-код с возможностью настройки стиля. QR-код ведёт на короткую ссылку, которая перенаправляет на ваш целевой URL. Целевой URL можно изменить позже без перегенерации QR-изображения. Поддерживает настраиваемые цвета, формы точек, формы углов и встраивание логотипа.

Параметры

background_colorstring
Шестнадцатеричный цвет фона QR-кода. По умолчанию: #ffffff (белый).
corner_styleenum
Форма поисковых узоров (угловые квадраты). square=классическая, extra-rounded=гладкая, dot=круглая.
dot_styleenum
Форма модулей данных: square=классическая, rounded=мягкие углы, dots=круги, classy-rounded=органическая.
error_correctionenum
Уровень коррекции ошибок. L=7%, M=15% (по умолчанию), Q=25%, H=30%. При наличии логотипа автоматически устанавливается H.
expires_atstring
Дата и время в формате ISO 8601. После этой даты сканирование возвращает 410 Gone вместо перенаправления.
foreground_colorstring
HEX-цвет для точек QR-кода. По умолчанию: #000000 (черный).
formatenum
Формат изображения. Рекомендуется "svg" (меньше весит, масштабируется, разбирается как текст). Используйте "png", только если нужно растровое изображение.
frame_border_radiusnumber
Радиус скругления углов рамки. Только для стиля 'rounded'.
frame_colorstring
HEX-цвет фона рамки. По умолчанию: #000000.
frame_styleenum
Декоративная рамка вокруг QR-кода. 'banner_bottom': текст снизу, 'banner_top': текст сверху, 'rounded': скруглённая рамка с текстом.
frame_textstring
Текст CTA на фрейме (например, 'Scan Me!', 'View Menu'). Максимум 30 символов. Требуется frame_style.
frame_text_colorstring
Шестнадцатеричный цвет текста рамки. По умолчанию: #ffffff.
gradientobject
Применяет градиент к точкам QR-кода и углам вместо сплошного foreground_color.
gtm_container_idstring
Идентификатор контейнера Google Tag Manager (например, 'GTM-ABC123'). Включает отслеживание GTM при сканировании QR-кодов через промежуточную HTML-страницу.
labelstring
Необязательная метка для идентификации этого QR-кода.
logo_sizenumber
Размер логотипа как отношение к ширине QR-кода (0.15-0.3). По умолчанию: 0.2.
logo_urlstring
URL изображения логотипа (PNG/JPG/SVG) или data:base64 URI. Размещается по центру QR-кода.
marginnumber
Поле свободной зоны в модулях. По умолчанию: 2.
scheduled_atstring
Дата и время в формате ISO 8601, когда цель автоматически переключается на scheduled_url.
scheduled_urlstring
URL замены, который активируется в scheduled_at.
target_urlstringобязательный
URL назначения, на который должен перенаправлять QR-код.
widthnumber
Ширина QR-кода в пикселях. По умолчанию: 400.

create_sms_qr

Создаёт QR-код, который открывает предварительно заполненное SMS-сообщение при сканировании. Устанавливает номер телефона и необязательный текст сообщения.

Параметры

background_colorstring
Шестнадцатеричный цвет фона.
corner_styleenum
Форма угла.
dot_styleenum
Форма точки.
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
labelstring
Я не вижу QR-код в нашем диалоге. Пожалуйста, прикрепите изображение QR-кода или укажите, какая информация в нём закодирована (например, ссылка, текст, контактные данные), и я помогу подобрать подпись.
logo_urlstring
URL логотипа или data URI.
messagestring
Текст предварительно заполненного SMS-сообщения.
phone_numberstringобязательный
Номер телефона для отправки SMS.

create_social_qr

Создает QR-код, который ссылается на профили в социальных сетях. При сканировании по короткой ссылке возвращает JSON-объект со всеми ссылками на платформы. Предоставляет по крайней мере одну ссылку на платформу.

Параметры

background_colorstring
Шестнадцатеричный цвет фона.
corner_styleenum
Форма угла.
dot_styleenum
Форма точки.
facebookstring
URL профиля/страницы Facebook.
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
githubstring
URL профиля GitHub.
instagramstring
URL профиля Instagram.
labelstring
Я не вижу QR-код в нашем диалоге. Пожалуйста, прикрепите изображение QR-кода или укажите, какая информация в нём закодирована (например, ссылка, текст, контактные данные), и я помогу подобрать подпись.
linkedinstring
URL профиля LinkedIn.
logo_urlstring
URL логотипа или data URI.
tiktokstring
URL профиля TikTok.
twitterstring
URL профиля Twitter/X.
websitestring
URL личного/корпоративного сайта.
youtubestring
URL-адрес канала YouTube.

create_text_qr

Создаёт QR-код, содержащий обычный текст. При сканировании текст отображается напрямую. Полезен для сообщений, заметок или любого произвольного содержимого.

Параметры

background_colorstring
Шестнадцатеричный цвет фона.
contentstringобязательный
Простой текстовый контент для кодирования.
corner_styleenum
Форма угла.
dot_styleenum
Форма точки.
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
labelstring
Я не вижу QR-код в нашем диалоге. Пожалуйста, прикрепите изображение QR-кода или укажите, какая информация в нём закодирована (например, ссылка, текст, контактные данные), и я помогу подобрать подпись.
logo_urlstring
URL логотипа или data URI.

create_vcard_qr

Создаёт QR-код, кодирующий контактную карточку (vCard). При сканировании камерой телефона предлагает сохранить контакт. Поддерживает все стандартные поля vCard и кастомную стилизацию QR.

Параметры

addressstring
Уличный адрес.
background_colorstring
Шестнадцатеричный цвет фона.
corner_styleenum
Форма угла.
dot_styleenum
Форма точки.
emailstring
адрес электронной почты
first_namestringобязательный
Имя контакта
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
labelstring
Я не вижу QR-код в нашем диалоге. Пожалуйста, прикрепите изображение QR-кода или укажите, какая информация в нём закодирована (например, ссылка, текст, контактные данные), и я помогу подобрать подпись.
last_namestringобязательный
Фамилия контакта
logo_urlstring
URL логотипа или data URI.
notestring
Дополнительные заметки
organizationstring
Компания или организация.
phonestring
Номер телефона.
titlestring
Должность.
urlstring
URL веб-сайта.

create_webhook

Регистрирует webhook-эндпоинт для получения уведомлений в реальном времени при сканировании QR-кодов. Возвращает секрет HMAC-SHA256 для проверки подписей webhook — храните его надёжно, он отображается только один раз.

Параметры

eventsenum[]
События, на которые можно подписаться. Сейчас поддерживается: "qr.scanned".
urlstringобязательный
URL конечной точки, который будет получать POST-запросы с данными о событиях сканирования.

create_wifi_qr

Создайте QR-код, который кодирует учетные данные WiFi. При сканировании камерой телефона он предлагает автоматически подключиться к сети WiFi. Для подключения не нужен интернет: учетные данные закодированы прямо в QR-изображении.

Параметры

background_colorstring
Шестнадцатеричный цвет фона.
corner_styleenum
Форма угла.
dot_styleenum
Форма точки.
encryptionenum
Тип шифрования. По умолчанию: WPA.
foreground_colorstring
HEX-цвет для точек.
formatenum
Формат изображения
frame_colorstring
Цвет фона рамки.
frame_styleenum
Стиль рамки вокруг QR-кода.
frame_textstring
Текст CTA на фрейме (макс. 30 символов).
frame_text_colorstring
Обрамить текст цветом.
hiddenboolean
Указывает, скрыта ли сеть. По умолчанию: false.
labelstring
Я не вижу QR-код в нашем диалоге. Пожалуйста, прикрепите изображение QR-кода или укажите, какая информация в нём закодирована (например, ссылка, текст, контактные данные), и я помогу подобрать подпись.
logo_urlstring
URL логотипа или data URI.
passwordstring
Пароль WiFi. Для открытых сетей не указывайте (используйте encryption='nopass').
ssidstringобязательный
Имя сети WiFi (SSID).

delete_qr_code

Навсегда удалите QR-код и всю статистику его сканирований. Короткая ссылка перестанет работать немедленно. Это действие нельзя отменить.

Параметры

short_idstringобязательный
Короткий ID QR-кода, который нужно удалить.

delete_webhook

Удалить вебхук-эндпоинт и все его логи доставки. Эндпоинт немедленно перестанет получать события.

Параметры

webhook_idnumberобязательный
Идентификатор удаляемого вебхука. Используйте list_webhooks, чтобы найти идентификаторы.

get_conversions

Получить статистику конверсий для QR-кода. Возвращает общее количество конверсий, общую стоимость, разбивку по названиям событий, дневные тренды и последние события. Используйте это для измерения ROI QR-кода и понимания, какие коды приносят наибольшую ценность.

Параметры

eventstring
Фильтрует по имени события (например, 'purchase').
periodenum
Период времени для агрегаций. По умолчанию: 30d.
short_idstringобязательный
short_id QR-кода, для которого нужно получить статистику конверсий.

get_custom_domain

Получить текущую конфигурацию кастомного домена и статус проверки DNS. Возвращает домен, активен ли DNS или находится в ожидании, и инструкции по настройке.

Параметры

Без параметров.

get_qr_analytics

Получает обогащённую аналитику сканирований для QR-кода. Возвращает общее количество сканирований, ежедневные тренды, разбивку по устройствам/браузерам/странам/реферерам с процентами, а также недавние события сканирования с распарсенным user-agent и геоданными.

Параметры

periodenum
Период времени для агрегаций. По умолчанию: 30d.
short_idstringобязательный
Короткий идентификатор QR-кода, для которого нужно получить аналитику.

get_qr_code

Извлекает детали существующего QR-кода по его короткому ID. Возвращает текущий целевой URL, метаданные и временные метки.

Параметры

short_idstringобязательный
Короткий ID QR-кода для поиска.

get_usage

Получить текущее использование и квоту для вашего API-ключа.

Параметры

Без параметров.

list_qr_codes

Выводит список всех управляемых QR-кодов с постраничной разбивкой. Возвращает короткие ID, целевые URL, метки и временные метки. Используйте это для просмотра или поиска существующих QR-кодов.

Параметры

limitnumber
Максимальное количество возвращаемых результатов.
offsetnumber
Количество пропускаемых результатов.

list_webhooks

Список всех зарегистрированных точек входа вебхуков для вашего API-ключа. HMAC-секрет не включается по соображениям безопасности.

Параметры

Без параметров.

manage_billing

Открывает платежный портал Stripe для управления подпиской, обновления способа оплаты или отмены. Возвращает URL портала — сообщите пользователю, что нужно открыть его в браузере. Работает только при наличии активной подписки Pro.

Параметры

Без параметров.

record_conversion

Запишите событие конверсии после сканирования (покупка, регистрация и т.д.) для вашего QR-кода. Используйте это для отслеживания ROI - например, когда пользователь сканирует QR-код и затем совершает покупку, запишите конверсию 'purchase' с суммой заказа. Для отслеживания на стороне клиента без кода используйте пиксель отслеживания: <img src="https://yourhost/t/{short_id}?event=purchase&value=49.99">.

Параметры

eventstringобязательный
Имя события конверсии (например, "purchase", "signup", "add_to_cart"). Используйте одинаковые имена, чтобы агрегировать статистику.
metadataobject
Необязательные метаданные JSON (например, идентификатор продукта, номер заказа).
short_idstringобязательный
short_id QR-кода, для которого выполняется это преобразование.
valuenumber
Необязательное денежное значение конверсии (например, 49.99).

register

Зарегистрируйтесь для получения API-ключа. Укажите ваш email, чтобы получить ключ сразу.

Параметры

emailstringобязательный
Ваш адрес электронной почты.
labelstring
Необязательная метка для идентификации этого API-ключа.

set_custom_domain

Установите собственный домен для сокращённых URL ваших QR-кодов (требуется тариф Pro). После установки все новые QR-коды будут использовать https://your-domain.com/r/... вместо URL по умолчанию. Необходимо настроить DNS (CNAME) так, чтобы он указывал на сервер QR Agent. Передайте domain=null, чтобы удалить собственный домен.

Параметры

domainstring | nullобязательный
Ваш собственный домен без протокола (например, 'qr.mybrand.com'). Передайте null, чтобы удалить.

set_redirect_rules

Устанавливает условные правила перенаправления на QR-код URL. Правила проверяются сверху вниз; каждое правило содержит массив условий (логика И): все должны совпасть. Используется URL первого совпавшего правила. Если ни одно правило не совпало, применяется target_url по умолчанию. Условия: 'device' (mobile/tablet/desktop), 'os' (iOS/Android/Windows/macOS/Linux), 'country' (ISO alpha-2, например 'FR'), 'language' (ISO 639-1, например 'fr'), 'time_range' ({start:'09:00',end:'17:00',timezone:'Europe/Paris'}), 'ab_split' ({percentage:50}). Объединяйте условия в одном правиле для логики И (например, mobile + FR). Передайте пустой массив, чтобы удалить все правила.

Параметры

rulesobject[]обязательный
Массив правил перенаправления. Пустой массив очищает все правила.
short_idstringобязательный
Короткий ID QR-кода (должен быть type='url').

set_utm_params

Устанавливает UTM-параметры отслеживания на QR-коде URL. Эти параметры автоматически добавляются к целевой ссылке при каждом перенаправлении после сканирования. Отслеживает сканирования QR-кода в Google Analytics или других инструментах аналитики. Удаляет все UTM-параметры, если 'clear' установлен в true.

Параметры

campaignstring
значение utm_campaign (например, 'summer_2026').
clearboolean
Установите значение true, чтобы удалить все UTM-параметры из этого QR-кода.
contentstring
Значение utm_content (вариант A/B-теста).
mediumstring
Значение utm_medium (например, 'print', 'qr', 'social').
short_idstringобязательный
Короткий ID QR-кода (должен быть type='url').
sourcestring
Значение utm_source (например, 'flyer', 'email', 'poster').
termstring
значение utm_term (ключевое слово платного поиска).

update_app_store_qr

Обновляет URL-адреса магазинов приложений QR-кода App Store. Частичные обновления объединяются с существующими данными.

Параметры

android_urlstring
URL магазина Google Play.
fallback_urlstring
Запасной URL.
ios_urlstring
URL-адрес Apple App Store.
labelstring
Обновляет метку.
short_idstringобязательный
Короткий идентификатор QR-кода App Store для обновления.

update_qr_destination

Изменяет перенаправление существующего QR-кода. Это ключевая функция «динамической ссылки»: изображение QR-кода остаётся прежним, но при сканировании теперь будет открываться новый URL. Идеально подходит для обновления кампаний, исправления битых ссылок или A/B-тестирования.

Параметры

expires_atstring | null
Дата истечения срока действия в формате ISO 8601. Установите значение null, чтобы удалить срок действия.
gtm_container_idstring | null
Идентификатор контейнера Google Tag Manager. Установите значение null, чтобы отключить отслеживание GTM.
labelstring
Опционально также обновляет метку.
scheduled_atstring | null
Дата активации в формате ISO 8601 для scheduled_url. Установите значение null, чтобы отменить.
scheduled_urlstring | null
URL запланированной замены. Установите значение null, чтобы отменить.
short_idstringобязательный
Короткий идентификатор QR-кода для обновления.
target_urlstringобязательный
Новый URL назначения.

update_social_qr

Обновляет ссылки на социальные сети для Social QR кода. Частичные обновления объединяются с существующими данными.

Параметры

facebookstring
Facebook URL
githubstring
URL GitHub.
instagramstring
Ссылка на профиль Instagram.
labelstring
Обновляет метку.
linkedinstring
Ссылка LinkedIn.
short_idstringобязательный
Короткий ID Social QR-кода для обновления.
tiktokstring
URL TikTok.
twitterstring
URL-адрес Twitter/X.
websitestring
URL веб-сайта.
youtubestring
URL-адрес YouTube.

update_vcard_qr

Обновляет контактные данные QR-кода vCard. Работает только с QR-кодами, созданными с type='vcard'. Частичные обновления объединяются с существующими данными. Примечание: обновление данных vCard изменяет содержимое QR-изображения.

Параметры

addressstring
Уличный адрес.
emailstring
адрес электронной почты
first_namestring
Имя контакта
labelstring
Обновляет метку.
last_namestring
Фамилия контакта
notestring
Дополнительные заметки
organizationstring
Компания или организация.
phonestring
Номер телефона.
short_idstringобязательный
Короткий идентификатор vCard QR-кода, который нужно обновить.
titlestring
Должность.
urlstring
URL веб-сайта.

update_wifi_qr

Обновляет учётные данные WiFi в QR-коде WiFi. Работает только с QR-кодами, созданными с type='wifi'. Примечание: обновление данных WiFi изменяет содержимое изображения QR-кода.

Параметры

encryptionenum
Тип шифрования.
hiddenboolean
Скрыта ли сеть.
labelstring
Обновляет метку.
passwordstring
Пароль WiFi
short_idstringобязательный
Короткий ID WiFi QR-кода для обновления.
ssidstring
Имя сети WiFi.

upgrade_to_pro

Обновитесь до Pro-плана ($19/месяц) для получения безлимитных QR-кодов, сканирований и вебхуков. Возвращает URL Stripe Checkout — скажите пользователю открыть его в браузере, чтобы завершить оплату. Обновление вступает в силу автоматически после оплаты.

Параметры

Без параметров.

`0.12.2`основная	09.06.2026
`0.12.1`	03.03.2026
`0.12.0`	02.03.2026
`0.11.0`	02.03.2026
`0.10.1`	02.03.2026
`0.10.0`	02.03.2026
`0.9.0`	02.03.2026
`0.8.0`	02.03.2026
`0.7.0`	02.03.2026
`0.6.0`	02.03.2026
`0.5.0`	02.03.2026
`0.4.0`	28.02.2026
`0.3.0`	27.02.2026
`0.2.0`	27.02.2026
`0.1.1`	24.02.2026
`0.1.0`	24.02.2026

Выберите клиент, чтобы установить benswel/qr-agent-core:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "benswel-qr-agent-core-ijw1an7ft1": {
      "command": "npx",
      "args": [
        "-y",
        "qr-for-agent"
      ],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.qrforagent.com"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "benswel-qr-agent-core-ijw1an7ft1": {
      "command": "npx",
      "args": [
        "-y",
        "qr-for-agent"
      ],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.qrforagent.com"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "benswel-qr-agent-core-ijw1an7ft1": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "qr-for-agent"
      ],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.qrforagent.com"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"benswel-qr-agent-core-ijw1an7ft1\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"qr-for-agent\"],\"env\":{\"API_KEY\":\"your-api-key\",\"BASE_URL\":\"https://api.qrforagent.com\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "benswel-qr-agent-core-ijw1an7ft1": {
      "command": "npx",
      "args": [
        "-y",
        "qr-for-agent"
      ],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.qrforagent.com"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add benswel-qr-agent-core-ijw1an7ft1 --env API_KEY=your-api-key --env BASE_URL=https://api.qrforagent.com -- npx -y qr-for-agent

Либо через JSON-конфиг:

claude mcp add-json benswel-qr-agent-core-ijw1an7ft1 "{\"command\":\"npx\",\"args\":[\"-y\",\"qr-for-agent\"],\"env\":{\"API_KEY\":\"your-api-key\",\"BASE_URL\":\"https://api.qrforagent.com\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add benswel-qr-agent-core-ijw1an7ft1 --env API_KEY=your-api-key --env BASE_URL=https://api.qrforagent.com -- npx -y qr-for-agent

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.benswel-qr-agent-core-ijw1an7ft1]
command = "npx"
args = ["-y", "qr-for-agent"]

[mcp_servers.benswel-qr-agent-core-ijw1an7ft1.env]
API_KEY = "your-api-key"
BASE_URL = "https://api.qrforagent.com"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите benswel/qr-agent-core, а в поле команды запуска — строку ниже:

npx -y qr-for-agent

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "benswel-qr-agent-core-ijw1an7ft1": {
      "command": "npx",
      "args": [
        "-y",
        "qr-for-agent"
      ],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.qrforagent.com"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "benswel-qr-agent-core-ijw1an7ft1": {
      "command": "npx",
      "args": [
        "-y",
        "qr-for-agent"
      ],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.qrforagent.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например benswel-qr-agent-core-ijw1an7ft1.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: benswel-qr-agent-core-ijw1an7ft1
    command: npx
    args:
      - "-y"
      - "qr-for-agent"
    env:
      API_KEY: your-api-key
      BASE_URL: https://api.qrforagent.com

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "benswel-qr-agent-core-ijw1an7ft1": {
      "command": "npx",
      "args": [
        "-y",
        "qr-for-agent"
      ],
      "env": {
        "API_KEY": "your-api-key",
        "BASE_URL": "https://api.qrforagent.com"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "qr-for-agent"
  ],
  "env": {
    "API_KEY": "your-api-key",
    "BASE_URL": "https://api.qrforagent.com"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx