För utvecklare och AI-agenter

Datan bakom slutbetyg.se går att fråga direkt genom MCP-servern: skolor, antagningsgränser, stipendier och meritvärdesberäkningen.

MCP-server

Servern följer Model Context Protocol och svarar bara med publik referensdata. Ingen elevdata går att nå genom den, oavsett vem som frågar. Varje anrop kostar en liten avgift som tas ut via xpay (x402). Du behöver en nyckel från xpay och lägger till den som ?key=… i adressen.

Adress

Transporten är Streamable HTTP: skicka JSON-RPC som POST till adressen, med Accept: application/json, text/event-stream.

Inloggning

Du loggar in med en xpay-nyckel i adressen (?key=xpay_sk_…). Det finns ingen inloggning hos oss och ingen elevdata bakom servern. Det öppna REST-API:t på /api/v1 är stängt just nu och svarar 402 med en hänvisning hit.

Exempel

Lägg till servern i Claude Code:

claude mcp add --transport http slutbetyg "https://slutbetyg.mcp.xpay.sh/mcp?key=xpay_sk_…"

Anropa ett verktyg med curl:

curl -X POST "https://slutbetyg.mcp.xpay.sh/mcp?key=xpay_sk_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"slutbetyg_search_schools","arguments":{"kommun":"Uppsala","skolform":"gymnasium","limit":5}}}'

Eller med kommandoraden:

export SLUTBETYG_KEY=xpay_sk_…
slutbetyg skolor --kommun Uppsala --skolform gymnasium
slutbetyg granser Uppsala --studievag naturvetenskap

Kommandorad

@slutbetyg/cli är ett litet skal runt MCP-servern, utan beroenden. Sätt SLUTBETYG_KEY till din xpay-nyckel. Paketet är inte publicerat på npm än.

Verktyg

• slutbetyg_search_schools

  Sök skolor på namn, kommun eller skolform.

• slutbetyg_get_school

  En skola med program och senaste antagningsgränser.

• slutbetyg_get_admission_cutoffs

  Antagningsgränser per skola och studieväg, 0–340.

• slutbetyg_calculate_meritvarde

  Räknar meritvärde eller jämförelsetal med de riktiga reglerna.

• slutbetyg_search_scholarships

  Sök stipendier som en elev faktiskt kan söka.

• slutbetyg_get_scholarship

  Ett stipendium med stiftelsens egen text.

• slutbetyg_list_scholarship_categories

  Stipendiernas kategorier och antal.

Sammanfattning för språkmodeller

/llms.txt beskriver vad datan är, var den kommer ifrån och vad som ännu inte är granskat.

Var datan kommer ifrån

Skolverkets skolenhetsregister och kursplaner, UHR:s antagningsstatistik, de kommunala antagningskanslierna och Länsstyrelsernas stiftelseregister. Varje rad bär sin källa.

Vill du bygga något större, eller saknar du något? Hör av dig via Kontakta oss.