Vascue Public Knowledge Search (MCP server)

License: MIT

A remote Model Context Protocol server that searches Vascue's public documentation: healthcare operations, the AI front desk for clinics, provider-side insurance claims automation, Cliniko integration, security, case studies and pricing.

Endpoint: https://www.vascue.io/mcp/search (streamable HTTP, no authentication)
Server card: https://www.vascue.io/.well-known/mcp/server-card.json
Registry name: io.vascue/public-knowledge-search
Operated by: Vascue Limited (ISO 27001 certified)

Public content only. This server indexes public product and educational pages. Never send patient information, claim documents, clinic credentials or booking requests to it. Agent-based clinic booking is a separate research pilot, not a public API.

Connect

Any MCP client that speaks streamable HTTP can connect to the endpoint directly.

Claude Code

claude mcp add --transport http vascue-search https://www.vascue.io/mcp/search

Cursor / Claude Desktop / other stdio-only clients (via mcp-remote)

{
  "mcpServers": {
    "vascue-search": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.vascue.io/mcp/search"]
    }
  }
}

Docker (the same stdio bridge, used by directory health checks)

docker build -t vascue-public-knowledge-search .
docker run -i --rm vascue-public-knowledge-search

Tools

One tool, no authentication, read-only.

`search`

Hybrid (keyword + vector) search over Vascue's public pages. Returns matching excerpts with their canonical https://www.vascue.io/... URLs so answers can cite the source.

Input	Type	Notes
`query`	`string` (required)	Natural-language question or keywords, e.g. "how does Vascue handle insurance claim pre-authorisation".
`ai_search_options.retrieval.retrieval_type`	`"hybrid" \| "vector" \| "keyword"`	Default hybrid.
`ai_search_options.retrieval.max_num_results`	`integer` 1–50	Default 8.
`ai_search_options.retrieval.match_threshold`	`number` 0–1	Default 0.35.
`ai_search_options.retrieval.context_expansion`	`integer` 0–3	Neighbouring chunks to include.

Query rewriting and reranking are disabled server-side; the server returns source chunks only and never a generated answer, so nothing is presented as a Vascue statement without a citation. Rate limit: 60 requests per minute per client.

Example call:

{ "name": "search", "arguments": { "query": "Cliniko integration for AI front desk" } }

The endpoint is backed by a Cloudflare AI Search instance over the approved public Markdown export of vascue.io (the service descriptor at https://www.vascue.io/.well-known/ai-search.json states what is and is not indexed).

Development

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-only

CI runs the same build and smoke test on every push and weekly, so the badge above doubles as an endpoint health indicator.

Directory build specs

Two equivalent stdio bridges are kept in this repo so a directory can build the server on whichever runtime it offers. Neither needs environment variables.

Runtime	Build steps	CMD
Node 22 (`Dockerfile`)	`["npm install -g [email protected]"]`	`["mcp-remote", "https://www.vascue.io/mcp/search", "--transport", "http-only"]`
Python 3.12+ (`bridge.py`)	`["pip install -r requirements.txt"]`	`["python", "bridge.py"]`

pip install -r requirements.txt && node scripts/smoke.mjs python bridge.py

Other machine-readable surfaces

https://www.vascue.io/llms.txt
https://www.vascue.io/openapi.json (public, read-only content API)
https://www.vascue.io/.well-known/agent-skills/index.json (agent skills; also at vascue-io/skills)

Licence

This repository (README, manifest, Dockerfile) is MIT licensed. The content served by the endpoint is Vascue's public website content.

Vascue Public Knowledge Search (MCP server)