Сервер Model Context Protocol, который ищет по публичной документации Vascue: операции в здравоохранении, ИИ-ресепшн для клиник, автоматизация страховых претензий на стороне провайдера, интеграция с Cliniko, безопасность, кейсы и цены.
Он доступен в двух эквивалентных формах:
Хостируемая (всегда актуальная): https://www.vascue.io/mcp/search — потоковый HTTP, без аутентификации.
Автономная (этот репозиторий): python server.py — локальный поиск BM25 по встроенному снимку публичных страниц (content/, обновляется при каждом релизе с помощью scripts/fetch_content.py). Без сетевых вызовов во время выполнения, поэтому работает и офлайн, и именно её запускают сборки из каталогов.
Конечная точка: https://www.vascue.io/mcp/search (потоковый HTTP, без аутентификации)
Карточка сервера: https://www.vascue.io/.well-known/mcp/server-card.json
Имя в реестре: io.vascue/public-knowledge-search
Оператор: Vascue Limited (сертифицирован по ISO 27001)
Только публичный контент. Этот сервер индексирует публичные продуктовые и образовательные страницы. Никогда не отправляйте на него информацию о пациентах, документы по претензиям, учётные данные клиник или запросы на бронирование. Бронирование клиник на основе агентов — это отдельный исследовательский пилот, а не публичный API.
Любой MCP-клиент, поддерживающий потоковый HTTP, может подключиться к конечной точке напрямую.
Claude Code
claude mcp add --transport http vascue-search https://www.vascue.io/mcp/searchCursor / Claude Desktop / другие клиенты только со stdio (через mcp-remote)
{
"mcpServers": {
"vascue-search": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://www.vascue.io/mcp/search"]
}
}
}Автономный локальный сервер (stdio; встроенный снимок, без сети)
pip install -r requirements.txt
python server.pyDocker (собирает автономный сервер)
docker build -t vascue-public-knowledge-search .
docker run -i --rm vascue-public-knowledge-searchRelated MCP server: Cliniko MCP Server
Один инструмент, без аутентификации, только чтение.
searchГибридный (ключевые слова + вектор) поиск по публичным страницам Vascue. Возвращает соответствующие фрагменты с их каноническими URL https://www.vascue.io/..., чтобы ответы могли ссылаться на источник.
Вход | Тип | Примечания |
|
| Вопрос на естественном языке или ключевые слова, например: «как Vascue обрабатывает предварительную авторизацию страховых претензий». |
|
| По умолчанию hybrid. |
|
| По умолчанию 8. |
|
| По умолчанию 0.35. |
|
| Соседние фрагменты для включения. |
Переписывание запросов и повторное ранжирование отключены на стороне сервера; сервер возвращает только исходные фрагменты и никогда не генерирует ответ, поэтому ничто не подаётся как заявление Vascue без цитаты. Ограничение скорости: 60 запросов в минуту на клиента.
Пример вызова:
{ "name": "search", "arguments": { "query": "Cliniko integration for AI front desk" } }Конечная точка работает на экземпляре Cloudflare AI Search поверх одобренного публичного экспорта Markdown с vascue.io (описание сервиса по адресу https://www.vascue.io/.well-known/ai-search.json указывает, что индексируется, а что нет).
docker build -t vascue-public-knowledge-search .
node scripts/smoke.mjs docker run -i --rm vascue-public-knowledge-search # initialize -> tools/list
node scripts/smoke.mjs npx -y mcp-remote https://www.vascue.io/mcp/search --transport http-onlyCI запускает те же сборку и смоук-тест при каждом пуше и еженедельно, поэтому значок выше также служит индикатором работоспособности конечной точки.
Каталоги, которые собирают сервер из исходников (например, Glama), запускают автономную форму. Сгенерированные образы сборки различаются (Python под управлением uv без pip или системный Python с внешним управлением PEP 668), поэтому используйте явное виртуальное окружение:
Шаги сборки: ["uv venv /opt/venv && uv pip install --python /opt/venv/bin/python -r requirements.txt"]
CMD: ["/opt/venv/bin/python", "server.py"]
Без переменных окружения.
Если есть обычный pip, подойдёт и просто pip install -r requirements.txt + ["python", "server.py"].
pip install -r requirements.txt
SMOKE_CALL_QUERY="Cliniko integration" node scripts/smoke.mjs python server.py # local server
node scripts/smoke.mjs python bridge.py # stdio bridge to the hosted endpoint
python scripts/fetch_content.py # refresh the content/ snapshothttps://www.vascue.io/llms.txt
https://www.vascue.io/openapi.json (публичный API контента только для чтения)
https://www.vascue.io/.well-known/agent-skills/index.json (навыки агентов; также на vascue-io/skills)
Этот репозиторий (README, манифест, Dockerfile) лицензирован по MIT. Контент, который отдаёт конечная точка, — это публичный контент веб-сайта Vascue.
Keyword (BM25) search over a bundled snapshot of vascue.io's public pages: healthcare-operations guides, the AI front desk for clinics, provider-side insurance-claims automation, Cliniko and Nookal integration, security and compliance pages, case studies, pricing and blog posts.
Use it to answer questions about what Vascue offers, how its products work and what it has published. One topic per call; cite the returned page URL for every excerpt you use.
Returns {"chunks": [...]} ordered by relevance; each chunk has url (the canonical https://www.vascue.io/... page), title, score (0-1 relative to the best match) and text (a Markdown excerpt). An empty list means the snapshot does not mention the topic - say so rather than guessing. The index is a point-in-time copy of the public site; https://www.vascue.io/mcp/search is the always-current hosted twin.
Runs fully locally: read-only, idempotent, no network calls, no authentication. Public content only: never send patient information, claim documents, clinic credentials or booking requests. It cannot book appointments or look up clinic data.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to look for, as a natural-language question or keywords, e.g. "how does claims pre-authorisation work" or "Cliniko integration". 3-15 words works best; one topic per call. | |
| max_num_results | No | Maximum excerpts to return (default 8). |
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations cover read-only, idempotent, non-destructive. The description adds substantial context beyond those: it runs fully locally with no network calls and no authentication, it is a point-in-time snapshot with an always-current hosted twin, and it imposes a data-sensitivity contract ('never send patient information, claim documents, clinic credentials or booking requests'). This safety framing is exactly the kind of behavioral disclosure that annotations alone do not convey.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Though long, every sentence earns its place: purpose, content scope, usage constraints, return format, snapshot caveat, hosted twin, execution model, and safety contract are each distinct and non-redundant. The high-level purpose is front-loaded before the supporting detail, and the safety constraints are positioned last with a clear warning nature. There is zero filler or repetition of annotation content.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a search tool with an output schema, the description is fully sufficient: it explains the relevance ordering and score semantics ('0-1 relative to the best match'), specifies the empty-list meaning, flags the snapshot-versus-live-site distinction, and defines the safety envelope. Even though an output schema exists, the description voluntarily clarifies return-value semantics, which removes any ambiguity about how to interpret results. Nothing an agent needs to call and use it correctly is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% — both `query` and `max_num_results` have detailed schema descriptions including the 3-15 word recommendation and default/maximum values. The description largely reinforces the schema's 'one topic per call' advice rather than adding new parameter-level meaning. It does clarify the return structure (chunks with url/title/score/text and relevance ordering), but that is output semantics more than parameter semantics, so the high-coverage baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource — 'Keyword (BM25) search over a bundled snapshot of vascue.io's public pages' — and enumerates the exact content domains covered (guides, clinic products, integrations, security/compliance, case studies, pricing, blog). This is far beyond a tautology; an agent knows precisely what content the tool can reach and that it operates over a snapshot, not the live site. No siblings exist, so the specificity of the resource alone distinguishes it cleanly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage context is explicit: 'Use it to answer questions about what Vascue offers, how its products work and what it has published,' with operational constraints — 'One topic per call; cite the returned page URL for every excerpt you use.' It also states clear negative capabilities ('It cannot book appointments or look up clinic data') and behavior on empty results ('say so rather than guessing'). Since there are no sibling tools to route among, this fully satisfies the when/when-not guidance dimension.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
v0.1.0searchWith only one tool, there is no risk of confusion between tools. The 'search' tool's purpose is unambiguous and clearly scoped to a specific domain (Vascue public knowledge).
The single tool is named 'search', which is a simple, clear verb that perfectly matches its function. There is no inconsistency to evaluate, and the name is intuitive.
The server provides exactly one tool, which is slightly below the typical 3-15 tool range. However, given the narrow purpose of 'Public Knowledge Search', a single search tool is well-scoped and earns its place, making the count appropriate.
The tool covers the entire domain of knowledge search for Vascue's public pages, including search, relevance ranking, and citation of sources. There are no obvious missing operations for its stated purpose; it is a complete, focused toolkit.
Hosted MCP server for Cliniko — patients, appointments, availability, and invoices for AI agents.
Search the SiteGPT documentation: setup, features, API reference, troubleshooting.
Search and fetch AgendaForge public documentation and marketing content. No authentication needed.
Docs Q&A: search 169 data and AI guides, fetch any page as markdown. Read-only, keyless.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/vascue-io/public-knowledge-search'
If you have feedback or need assistance with the MCP directory API, please join our Discord server