Hotline Finance FAQ MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Hotline Finance FAQ MCP Server what are the FAQ categories?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Hotline Finance FAQ — MCP Server
MCP сервер для отримання FAQ та глосарію зі страхового сервісу hotline.finance.
Підтримує два режими запуску:
stdio — для Cursor / Claude Desktop
HTTP — для ChatGPT та інших клієнтів з підтримкою мережевого MCP
Інструменти (Tools)
list_faq_categories
Повертає повний список доступних категорій FAQ з їх slug-назвами (80+ категорій).
Параметрів немає. Slug потрібен для виклику get_faq_questions.
get_faq_questions
Отримує питання та відповіді FAQ для вказаної категорії з hotline.finance.
У ChatGPT відображає інтерактивний UI-віджет з картками питань.
Параметр | Тип | Опис |
|
| Slug категорії (наприклад: |
find_faq ✦ sampling
Приймає довільний текстовий запит українською, автоматично визначає категорію через LLM-класифікацію (createMessage) та повертає відповідні FAQ. Якщо клієнт не підтримує sampling — повертає підказку з доступними категоріями.
Потребує підтримки
samplingз боку клієнта (Cursor, Claude Desktop).
Параметр | Тип | Опис |
|
| Довільний текст (наприклад: |
faq_wizard ✦ elicitation
Інтерактивний майстер без аргументів. Показує форму з 10 найпопулярніших видів страхувань через elicitInput, отримує вибір користувача та повертає відповідні FAQ. Якщо клієнт не підтримує elicitation — повертає список slug для ручного виклику.
Потребує підтримки
elicitationз боку клієнта.
get_glossary_list
Повертає список усіх термінів страхового глосарію (24 терміни) з їх slug та назвами.
Параметрів немає. Slug потрібен для виклику get_glossary_item.
get_glossary_item
Отримує детальний опис терміну страхового глосарію: назву, пояснення та пов'язані питання.
Параметр | Тип | Опис |
|
| Slug терміну (наприклад: |
Related MCP server: mcp-docs
Промпти (Prompts)
Промпти — це готові шаблони розмов, доступні як slash-команди в Cursor і Claude Desktop. Аргументи мають автодоповнення при наборі завдяки completable().
faq-search
Шаблон для пошуку FAQ по категорії страхування. Аргумент category автодоповнюється зі списку 80+ slug.
Аргумент | Тип | Опис |
|
| Slug категорії з автодоповненням по |
glossary-explain
Шаблон для пояснення страхового терміну. Аргумент slug автодоповнюється зі списку термінів глосарію.
Аргумент | Тип | Опис |
|
| Slug терміну з автодоповненням по |
Ресурси (Resources)
ui://widget/faq.html
HTML-віджет для відображення FAQ-карток в інтерфейсі ChatGPT (ext-apps).
Підключається автоматично при виклику get_faq_questions, find_faq та faq_wizard.
Встановлення та запуск
npm installРежим розробки (tsx)
npm start
# або з HTTP-портом:
PORT=3333 npm startПродакшн-збірка (TypeScript → JS)
npm run build # компілює TypeScript у build/
npm run build:start # компілює та запускаєРежим 1 — Cursor / Claude Desktop (stdio)
Додай до конфігу MCP сервера зібраний JS після npm run build:
{
"mcpServers": {
"hotline-faq": {
"command": "node",
"args": [
"c:\\Users\\Denys\\Desktop\\WORK\\MCP_FAQ_Server\\build\\index.js"
]
}
}
}Cursor: Settings → MCP → Add server
Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json
В Cursor і Claude Desktop будуть доступні:
Промпти
faq-searchтаglossary-explainяк slash-команди з автодоповненнямІнструмент
find_faqз LLM-класифікацією (через sampling)Інструмент
faq_wizardз формою вибору (через elicitation)
Режим 2 — ChatGPT / HTTP-клієнти
HTTP-сервер підтримує два протоколи одночасно:
Streamable HTTP (MCP 2025-06-18) — основний протокол
Legacy SSE (MCP 2024-11-05) — зворотна сумісність
MCP endpoint: POST /mcp
Локальна розробка з ngrok
# Термінал 1 — запуск сервера
PORT=3333 npm start
# Термінал 2 — публічний тунель
ngrok http 3333Скопіюй URL з ngrok (наприклад https://abc123.ngrok.app) і в ChatGPT:
Натисни
+→ Add connector → вставитиhttps://abc123.ngrok.app/mcp
В ChatGPT доступні всі інструменти. Промпти та sampling/elicitation залежать від підтримки клієнта.
Структура проекту
MCP_FAQ_Server/
├── package.json
├── tsconfig.json
├── public/
│ └── faq-widget.html ← HTML-віджет (iframe в ChatGPT)
└── src/
├── index.ts ← Точка входу (вибір транспорту)
├── server.ts ← Створення MCP сервера, реєстрація інструментів
├── config.ts ← Категорії FAQ, терміни глосарію, константи
├── types.ts ← TypeScript типи
├── api/
│ ├── faq.ts ← Запити до hotline.finance/api/faq-questions
│ └── glossary.ts ← Запити до hotline.finance/api/glossary
├── prompts/
│ ├── faq-search.ts ← Промпт faq-search + completable(CATEGORY_SLUGS)
│ └── glossary-explain.ts ← Промпт glossary-explain + completable(GLOSSARY_SLUGS)
├── tools/
│ ├── list-categories.ts ← Інструмент list_faq_categories
│ ├── get-faq-questions.ts ← Інструмент get_faq_questions
│ ├── get-glossary-list.ts ← Інструмент get_glossary_list
│ ├── get-glossary-item.ts ← Інструмент get_glossary_item
│ ├── find-faq.ts ← Інструмент find_faq (createMessage / sampling)
│ └── faq-wizard.ts ← Інструмент faq_wizard (elicitInput / elicitation)
├── resources/
│ └── faq-widget.ts ← Ресурс ui://widget/faq.html
├── transports/
│ ├── http.ts ← HTTP-транспорт (Streamable + SSE)
│ └── stdio.ts ← stdio-транспорт
└── utils/
├── categories.ts ← Пошук категорії за slug
├── glossary.ts ← Пошук терміну за slug
└── html.ts ← Очищення HTML-тегів з відповідейКатегорії FAQ
Повний список доступний через інструмент list_faq_categories.
Деякі з них:
Slug | Назва |
| Автоцивілка |
| Туристичне страхування |
| КАСКО |
| Зелена картка |
| Страхування житла |
| Страховка для виїзду за кордон |
| Питання Підтримка з облікового запису |
| Загальні питання |
| МініКАСКО |
| Бонуси |
| Штрафи |
| Реферальна програма |
Щоб додати нові категорії — оновіть масив
CATEGORIESуsrc/config.ts.
Терміни глосарію
Повний список доступний через інструмент get_glossary_list.
Деякі з них:
Slug | Назва |
| Автоцивілка (ОСЦПВ) |
| Зелена картка |
| КАСКО |
| Франшиза |
| Страховка (страховий поліс, договір страхування) |
| Страховий випадок |
| Страхова сума |
| Туристичне Страхування |
Щоб додати нові терміни — оновіть масив
GLOSSARY_ENTRIESуsrc/config.ts.
Стек
TypeScript + tsx (dev runner)
@modelcontextprotocol/sdk — MCP протокол (Tools, Prompts, Resources, sampling, elicitation)
@modelcontextprotocol/ext-apps — підтримка UI-ресурсів (ChatGPT ext-apps)
zod + completable() — валідація та автодоповнення аргументів промптів
Вбудований
node:http— HTTP-сервер без зовнішніх фреймворків
Available Tools
5 toolsfaq_wizardМайстер FAQ — hotline.financeA
Інтерактивний вибір категорії страхування через форму (elicitation). Показує користувачу список найпопулярніших видів страховок, отримує вибір та повертає відповідні FAQ. Якщо клієнт не підтримує elicitation — повертає підказку.
Inputs: no named parameters.
find_faqЗнайти FAQ за запитом — hotline.financeA
Приймає довільний текстовий запит українською, визначає підходящу категорію FAQ через LLM-класифікацію (sampling) та повертає відповідні питання з hotline.finance. Якщо клієнт не підтримує sampling — повертає підказку з доступними категоріями.
Inputs: query (required).
get_faq_questionsОтримати питання FAQ — hotline.financeA
Отримує питання та відповіді FAQ з hotline.finance для вказаної категорії страхування. Відображає інтерактивний список питань. Передай назву категорії (наприклад: автоцивілка, туризм, загальні, виїзд-за-кордон).
Inputs: category (required).
get_glossary_itemОтримати термін глосарію — hotline.financeARead-only
Отримує детальний опис терміну глосарію страхування з hotline.finance за його slug. Повертає назву, пояснення та пов'язані питання. Список термінів зі slug доступний через get_glossary_list.
Inputs: slug (required).
list_faq_categoriesСписок категорій FAQ — hotline.financeARead-only
Повертає список доступних категорій FAQ сервісу hotline.finance. Використовуй slug як параметр category у get_faq_questions.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The tools have distinct purposes: listing categories, getting questions by category, getting a glossary item, free-text search, and an interactive wizard. There is some overlap among get_faq_questions, find_faq, and faq_wizard, but descriptions clarify their different input modes.
Most tools follow a verb_noun pattern (list_faq_categories, get_faq_questions, get_glossary_item, find_faq), but faq_wizard deviates by using a noun-only name, breaking the otherwise consistent pattern.
With 5 tools, the server is well-scoped for an FAQ and glossary service. Each tool serves a clear and non-redundant role, and the count feels appropriate.
Core FAQ browsing and glossary lookup are covered, but there is a notable gap: get_glossary_item references a get_glossary_list tool that is not present in the set. This creates a dead end for discovering glossary terms.
Maintenance
Related MCP Connectors
MCP server for querying Forkast documentation
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server for integrating with various LLM clients like Claude Desktop.1162MIT
- AlicenseNot gradedqualityDmaintenanceGeneric MCP server that exposes Markdown documentation to LLMs, enabling them to search and answer questions about any software documentation.MIT
- FlicenseNot gradedqualityDmaintenanceMCP server enabling Claude Desktop to answer questions from local Word and PDF documents by searching a vector index built from their contents.-
- FlicenseNot gradedqualityBmaintenanceMCP server for a content-first knowledge base, enabling AI agents to search (full-text, semantic, hybrid) and retrieve Markdown documents, list content, and find related docs.-