# Vårdbetyg MCP server

Vårdbetyg (https://vardbetyg.se) is an independent Swedish service with ratings of primary care health centres (vårdcentraler),
built on open data: Nationell Patientenkät (the National Patient Survey, SKR) and Socialstyrelsen's waiting times. This
server lets an AI assistant look up a health centre's rating, list the health centres in a municipality and read the
best-rated in a county or in the whole country. The content is the same as in the public files on the site
(/vardcentral/<id>/data.json, /kommun/<id>/data.json, /lan/<id>/svar.txt and /basta/svar.txt), licensed CC BY 4.0. The data is in Swedish.

- Endpoint: https://vardbetyg.se/mcp (Streamable HTTP, JSON responses, no sessions, no streaming)
- Authentication: none. The data is public.
- Tools: 5, all read only (readOnlyHint true, destructiveHint false, openWorldHint false)
- Personal health data: none is handled. The server takes a place or a health centre name, never anything about a person.
- Support: hej@vardbetyg.se
- Privacy: https://vardbetyg.se/integritet

## Add it to your tool

The steps follow each tool's own documentation (checked 18 November 2026).

- Claude: open https://claude.ai/directory/vardbetyg and add the connector.
- Visual Studio Code with Copilot: add this to `.mcp.json` in the workspace root.

  ```json
  { "mcpServers": { "vardbetyg": { "type": "http", "url": "https://vardbetyg.se/mcp" } } }
  ```

- Cursor: add this to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` in a project.

  ```json
  { "mcpServers": { "vardbetyg": { "url": "https://vardbetyg.se/mcp" } } }
  ```

- Gemini CLI: run `gemini mcp add --transport http --scope user vardbetyg https://vardbetyg.se/mcp`. Google moved free and
  Google One accounts from Gemini CLI to Antigravity CLI in June 2026.
- Microsoft Copilot Studio: on the agent's Tools page, select Add a tool, New tool and Model Context Protocol. Give a
  name, a short description and the server URL https://vardbetyg.se/mcp, choose None as authentication and select Create.

## Tools

### search_health_centres

Search Swedish health centres by name or place. Finds Swedish primary care health centres (vårdcentraler) whose name or municipality matches the text, and municipalities with that name. Returns up to 5 health centres with an id, municipality, whether a Vårdbetyg rating exists and the page address. Use the id with get_health_centre, or the municipality id with list_municipality_health_centres. Read only, no account needed.
  Input: `query` (text, 2 to 80 characters). The name of a health centre or the municipality the question is about, for example "Capio Vårdcentral Lund" or "Lund". This is the place the question concerns, not where the user is.

### get_health_centre

Get one health centre: rating, survey answers and waiting-time shares. Returns the public facts for one Swedish health centre by its id (from search_health_centres): a ready answer sentence, the Vårdbetyg score 0 to 100 with the number of survey answers, the national average, the survey year, the dimensions of Nationell Patientenkät, the shares assessed within the waiting-time limits, a citation line with the licence, and the page address. A missing score means too few answers, not poor care. Read only.
  Input: `id` (text, 1 to 120 characters). The health centre id (slug) from search_health_centres, for example "capio-vardcentral-lund".

### list_municipality_health_centres

List the health centres in a Swedish municipality. Returns a municipality answer file: the sentence about the best-rated health centre, the health centres sharing places 1 to 3 with their score and number of answers, the care guarantee where it exists, a comparison with similar municipalities, the survey year, the citation line and an alphabetical list of all health centres (name and id). Never a list from the bottom. Takes the municipality name or id. Read only.
  Input: `municipality` (text, 2 to 80 characters). The municipality name ("Lund") or id ("lund") the question is about. This is the place the question concerns, not where the user is.

### top_health_centres_in_county

The best-rated health centres in a Swedish county. Returns a county answer file as text: the sentence about the best-rated health centres in the county, the ones sharing places 1 to 3 with score and number of answers, the care guarantee where it exists, the survey year, the citation line and the county municipalities. Only the top, never a list from the bottom. Takes the county id, for example "skane", "stockholm" or "vastra-gotaland". Read only.
  Input: `county` (text, 3 to 60 characters). The county name ("Skåne", "Västra Götaland") or id ("skane", "vastra-gotaland").

### top_health_centres_in_sweden

The best-rated health centres in Sweden. Returns the national answer file as text: the sentence about the best-rated health centres in Sweden, the ones sharing places 1 to 3 with score and number of answers, the survey year, the citation line, the number of health centres and the counties with the address of each county answer file. Only the top, never a list from the bottom. Takes no input. Read only.

## How to answer

Say which survey year and date the figures are from, and link the page address in the result. Cite as: Vårdbetyg
(vardbetyg.se), <page address>, CC BY 4.0, <the date the file says it was updated>. A Vårdbetyg is a comparison from
survey answers, not a verdict on the quality of care and not medical advice: for urgent symptoms call 112, for advice
call 1177.

## What is not in the data

Opening hours, the share with a named regular doctor, the sample sizes behind waiting times, listing status per health
centre, Google reviews, awards and the results of health centres' own patient surveys. A missing score means too few
survey answers and says nothing about the care. Lists show the highest-rated first with places shared when scores are
equal. There is no worst-first list and no way to sort from the bottom. Ratings cannot be bought: no payment changes a
figure or a place.

## Limits

Each tool has a time limit and a size limit, and the endpoint has a rate limit for all callers together
(240 calls a minute per server instance). A refused call returns HTTP 429 with Retry-After, or a tool error that
says what went wrong.

## What we count

Per day: how many calls, for which tool, from which kind of assistant (Claude, ChatGPT or other) and whether it
succeeded. We do not store IP addresses, the text of a question or the arguments of a call. See https://vardbetyg.se/integritet.
