WebAsk MCP server
Commit Oct 1, 2026Build surveys, read answers, and generate reports through an AI assistant.
Also known as WebAskio/webask-mcp, webask-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 1, 2026
- License
- MIT
What is WebAsk MCP?
WebAsk builds surveys, read answers, and generate reports through an AI assistant.
Summary generated from the project's README
About WebAsk MCP server
WebAsk provides an MCP server that allows users to manage the entire lifecycle of surveys through an AI assistant. It enables the creation of questionnaires based on natural language descriptions, the management of question logic and branching, and the distribution of surveys via links or QR codes. The server supports a wide range of clients including Claude Desktop, Cursor, VS Code, and Gemini CLI, using a streamable HTTP transport method.
Developers and researchers can use the 161 available tools to read responses, tag data, and generate detailed reports in formats like Excel, CSV, Word, or PDF. The system includes 25 specialized skills that guide the AI through complex workflows, such as analyzing open-ended text answers or performing A/B testing significance checks. Users connect by providing an API key obtained from their WebAsk dashboard, which is then used in the authorization header for all requests. The server operates with a limit of 180 requests per minute.
What you can do with it
- 1Create surveys from descriptionsAsk your AI assistant to build a complete customer feedback form based on a simple text brief.
- 2Analyze qualitative survey dataTransform hundreds of lines of free-text responses into organized themes with supporting quotes.
- 3Generate client-ready reportsRequest a summary of survey results that can be shared directly with stakeholders as a file or link.
- 4Monitor survey healthIdentify exactly which question causes respondents to abandon the survey.
Written from the project's README. Every use case is checked against a quote from it.
How to install WebAsk MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall WebAsk MCP in Claude Code
$ claude mcp add --transport http webask-mcp https://mcp.webask.io/mcp/v1Install WebAsk MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"webask-mcp": {
"url": "https://mcp.webask.io/mcp/v1"
}
}
}Install WebAsk MCP in VS Code
.vscode/mcp.json
{
"servers": {
"webask-mcp": {
"type": "http",
"url": "https://mcp.webask.io/mcp/v1"
}
}
}Install WebAsk MCP in VS Code CLI
$ code --add-mcp '{"name":"webask-mcp","type":"http","url":"https://mcp.webask.io/mcp/v1"}'Install WebAsk MCP in Codex
$ codex mcp add webask-mcp --url https://mcp.webask.io/mcp/v1Install WebAsk MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.webask-mcp] url = "https://mcp.webask.io/mcp/v1"
Install WebAsk MCP in Gemini CLI
$ gemini mcp add -s user --transport http webask-mcp https://mcp.webask.io/mcp/v1Install WebAsk MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"webask-mcp": {
"url": "https://mcp.webask.io/mcp/v1",
"type": "http"
}
}
}Configuration
WEBASK_AUTH
| Name | Description | |
|---|---|---|
| WEBASK_AUTH | — |
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablewebaskio/webask-mcp is public and reachablegithub.com/webaskio/webask-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-01github.com/webaskio/webask-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubMCP-сервер WebAsk и готовые навыки (skills) для ИИ-ассистента. Ассистент соберёт анкету по описанию, проверит её перед запуском, прочитает ответы и сделает отчёт для заказчика. Вы только говорите, что нужно.
Работает с Claude Code, Claude Desktop, Cursor, VS Code, Codex и Gemini CLI.
Вы: Сделай анкету для клиентов автосервиса: оценить работу и собрать контакты
для повторной записи.
ИИ: ✓ подобрал типы вопросов ✓ собрал 7 вопросов и 2 ветвления ✓ применил тему
Черновик готов, пока его видите только вы. Публикуем?
Быстрый старт
- Создайте ключ. В кабинете WebAsk откройте Настройки → API / MCP и нажмите «Создать API-ключ». Ключ показывается один раз, сохраните его сразу.
- Подключите сервер
https://mcp.webask.io/mcp/v1к ассистенту. Готовые команды и конфиги ниже. - Попросите: «Покажи мои опросы и сколько ответов пришло за неделю».
Claude Code: всё одной установкой
Плагин ставит MCP-сервер и все 25 навыков сразу. Ключ Claude Code спросит при установке и сохранит в системном хранилище паролей.
/plugin marketplace add WebAskio/webask-mcp
/plugin install webask@webask
Если нужен только сервер, без навыков:
claude mcp add --transport http webask https://mcp.webask.io/mcp/v1 \
--header "Authorization: Bearer YOUR_API_KEY"
Другие клиенты
В один клик:
VS Code спросит ключ сам. В Cursor после установки откройте настройки сервера webask и замените
YOUR_API_KEY на ключ.
Вручную — в конфигах ниже замените YOUR_API_KEY на свой ключ.
Settings → Developer → Edit Config, в файл claude_desktop_config.json. Нужен установленный Node.js:
его использует mcp-remote, он передаёт ключ серверу.
{
"mcpServers": {
"webask": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.webask.io/mcp/v1", "--header", "Authorization:${WEBASK_AUTH}"],
"env": { "WEBASK_AUTH": "Bearer YOUR_API_KEY" }
}
}
}
После сохранения перезапустите Claude Desktop.
Settings → MCP → Add new global MCP server, или напрямую в файл ~/.cursor/mcp.json:
{
"mcpServers": {
"webask": {
"url": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Файл .vscode/mcp.json в проекте. Ключ VS Code спросит при первом запуске и сохранит у себя, в файле его
не будет:
{
"inputs": [
{ "type": "promptString", "id": "webask-api-key", "description": "WebAsk API key", "password": true }
],
"servers": {
"webask": {
"type": "http",
"url": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer ${input:webask-api-key}" }
}
}
}
В файл ~/.codex/config.toml:
[mcp_servers.webask]
url = "https://mcp.webask.io/mcp/v1"
bearer_token_env_var = "WEBASK_API_KEY"
Ключ Codex берёт из переменной окружения: export WEBASK_API_KEY=YOUR_API_KEY.
Расширением — сервер и все навыки сразу, ключ Gemini спросит при установке:
gemini extensions install https://github.com/WebAskio/webask-mcp
Или только сервер, в файл ~/.gemini/settings.json:
{
"mcpServers": {
"webask": {
"httpUrl": "https://mcp.webask.io/mcp/v1",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Те же конфиги отдельными файлами лежат в clients/, пошаговая инструкция — в
docs/connect.md.
Что это такое
| Адрес сервера | https://mcp.webask.io/mcp/v1 |
| Транспорт | Streamable HTTP, на своей стороне ничего разворачивать не нужно |
| Авторизация | API-ключ в заголовке Authorization: Bearer … |
| Инструменты | 161: 57 только читают, 24 — необратимые, сервер их помечает. Весь список |
| Права | Те же, что в конструкторе: роль участника и тариф пространства |
| Лимиты | 180 запросов в минуту, ссылки на выгрузки действуют час |
Что умеет
Опросы. Собрать опрос по описанию или из шаблона, настроить вопросы, ветвления, переменные и скрытые поля. Применить тему, опубликовать, вернуть прошлую версию.
Раздача. Ссылка, QR-код, пароль на опрос, версия для печати, промокоды, онлайн-запись с расписанием.
Ответы. Прочитать, разметить тегами и заметками, скрыть лишнее, убрать тестовые.
Отчёты. Сводка, отчёт с фильтрами, AI-отчёт, публичные ссылки для заказчика. Выгрузки в Excel, CSV, SPSS, Word и PDF.
Заявки. Уведомления на почту и свой SMTP, вебхуки с журналом доставки, CRM и amoCRM, Google Таблицы, мессенджеры, Zapier.
Аккаунт. Участники и роли, папки и доступ к ним, брендинг, свой домен, файлы и хранилище.
Инструменты по разделам — в docs/tools.md, готовые фразы — в docs/prompts.md.
Навыки
Навык — готовая методика для ассистента. Вы просите «разбери открытые ответы», а навык подсказывает, какие инструменты вызвать, в каком порядке и как показать результат. Кода в навыках нет, это текстовые инструкции: ничего не устанавливается и не запускается.
Собрать и раздать
| Навык | Что даёт | Скачать |
|---|---|---|
| Сборка опроса по описанию | Опишите задачу словами — получите готовый опрос, а не список вопросов | ZIP |
| Переписать формулировки | Переписывает вопросы так, чтобы опрос дочитывали, — и начинает с данных, а не со вкуса | ZIP |
| Логика показа и маршруты | Собирает ветвление так, чтобы ни один респондент не упёрся в тупик | ZIP |
| Материалы для запуска | Собирает всё для запуска разом: ссылки с метками, тексты анонса и QR-код | ZIP |
| Раздача опроса | Готовит опрос к раздаче так, чтобы потом было видно, из какого канала пришли ответы | ZIP |
Проверить перед запуском
| Навык | Что даёт | Скачать |
|---|---|---|
| Проверка опроса перед запуском | Находит то, что сломается на живых респондентах, пока ссылку ещё никому не отправили | ZIP |
| Качество собранных данных | Отвечает, можно ли верить этим данным, до того как на них построят выводы | ZIP |
Понять результаты
| Навык | Что даёт | Скачать |
|---|---|---|
| Разбор результатов опроса | Отвечает на «ну и что там по опросу» цифрами с выводом, а не выгрузкой сырых ответов | ZIP |
| Анализ A/B-вариантов | Отвечает, реальна разница между вариантами или это случайность | ZIP |
| Сравнение с собой прошлым | Сравнивает опрос с ним же прошлым: отдельная цифра ничего не значит, разница — значит | ZIP |
| Разбор свободных ответов | Превращает сотню строк свободного текста в несколько тем с числами и цитатами | ZIP |
| Воронка прохождения | Показывает, на каком вопросе люди закрывают вкладку — и почему | ZIP |
| Сколько ответов нужно | Отвечает, хватает ли уже собранного и сколько ещё нужно, чтобы выводы не развернулись | ZIP |
| Хронология опроса | Отвечает на «почему перестали приходить ответы», сопоставляя сбор с историей правок | ZIP |
| Сравнение источников | Показывает, какой канал привёл людей, а какой — только цифры | ZIP |
| Результаты — заказчику | Собирает результаты в то, что можно отправить: ссылку, файл или отчёт с выводами | ZIP |
| Оформление отчётов и тема опроса | Приводит в порядок то, что видят снаружи: тему опроса, палитру отчётов и логотип | ZIP |
Довести заявки
| Навык | Что даёт | Скачать |
|---|---|---|
| Уведомления о новых ответах | Настраивает, куда сообщать о новых ответах, и чинит, когда сообщать перестало | ZIP |
| Настройка вебхука | Заводит отправку ответов на ваш адрес и сразу проверяет, что приёмник их принял | ZIP |
| Почему ответы не уходят | Находит, почему заявки не доходят до CRM, Telegram или таблицы — и что с этим делать | ZIP |
| Качество заявок | Считает не завершаемость, а сколько людей оставили пригодный контакт | ZIP |
Порядок в аккаунте
| Навык | Что даёт | Скачать |
|---|---|---|
| Аудит аккаунта | Показывает одним отчётом, где аккаунт теряет ответы, место и деньги | ZIP |
| Порядок в ответах | Убирает тестовые прохождения и дубли, но сначала показывает, что именно попадёт под чистку | ZIP |
| Порядок в аккаунте | Навык разберёт накопившиеся опросы, сохранит ответы и покажет план изменений до того, как что-либо поменяет. | ZIP |
| Участники и доступы | Разбирается, почему участник не видит опросы, и выдаёт ровно те права, что нужны | ZIP |
Все навыки одним архивом: webask-skills-ru.zip. Витрина с примерами результата — webask.io/skills.
Как поставить навык без плагина
Одной командой в любой ассистент — skills сам найдёт установленные агенты и спросит, куда положить навыки:
npx skills add https://github.com/WebAskio/webask-mcp/tree/main/skills
Или вручную: распакуйте архив в папку, из которой ваш ассистент читает навыки, и перезапустите его.
| Ассистент | Папка в проекте |
|---|---|
| Claude Code | .claude/skills/ |
| Codex, Cursor | .agents/skills/ |
| Gemini CLI | .gemini/skills/ |
Вашего ассистента нет в таблице? Попробуйте .agents/skills/, эту папку понимает большинство клиентов.
Подробности — в skills/README.md.
Безопасность
- Ключ даёт ассистенту те же права, что у вас в пространстве. Отозвать его можно в любой момент: Настройки → API / MCP.
- Необратимые инструменты — удаление опросов, чистка ответов и подобное — сервер помечает аннотацией
destructiveHint, чтобы клиент видел, что вызов не отменить. - В каждом навыке есть раздел «Чего не делать»: что ассистенту нельзя делать без вашего слова.
- Секретов в репозитории нет и не должно быть: в конфигах вместо ключа стоит
YOUR_API_KEY. Нашли что-то похожее на настоящий ключ — напишите нам, см. SECURITY.md.
Ссылки
Лицензия
MIT, см. LICENSE. Лицензия распространяется на содержимое репозитория: документацию, конфиги и навыки. Сам сервис WebAsk работает по пользовательскому соглашению.
WebAsk MCP questions
How do I add WebAsk MCP to Claude Code?
Run claude mcp add --transport http webask-mcp https://mcp.webask.io/mcp/v1 in your terminal. Add --scope user to make it available in every project.
How do I add WebAsk MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I get started with WebAsk MCP?
Create an API key in your WebAsk dashboard under Settings → API / MCP, then connect the server URL to your AI assistant.
Which AI clients are supported?
The server works with Claude Code, Claude Desktop, Cursor, VS Code, Codex, and Gemini CLI.
What kind of data can I export?
You can export data to Excel, CSV, SPSS, Word, and PDF formats.