MCP

Alevas data i din AI-assistent

Varje publicerad endpoint finns också som ett verktyg via Model Context Protocol. Assistenten hittar rätt datamängd, ställer frågan och får svaret med källa och licens.

Anslut

Servern nås över Streamable HTTP på:

https://api.aleva.se/mcp

Du behöver inget konto och ingen nyckel. Lägg till adressen som en MCP-server eller anpassad koppling i din klient. Allt är läsning: verktygen ändrar ingenting.

Klienter

Claude

I Claude-appen: lägg till en anpassad koppling (custom connector) med adressen ovan. I Claude Code:

claude mcp add --transport http aleva https://api.aleva.se/mcp

ChatGPT

Lägg till en anpassad koppling eller app med adressen ovan (kräver att utvecklarläget är på i ChatGPT:s inställningar).

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "aleva": {
      "url": "https://api.aleva.se/mcp"
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "aleva": {
      "type": "http",
      "url": "https://api.aleva.se/mcp"
    }
  }
}

Andra klienter fungerar på samma sätt: de behöver bara adressen.

Gränser och nycklar

Ett verktygsanrop räknas som ett vanligt API-anrop till samma endpoint, med samma gränser. Utan nyckel: 10 kostnadsenheter per minut och 200 per dygn och IP-adress. Med en nyckel gäller nyckelns gränser. Skicka den som en rubrik i klientens konfiguration:

{
  "mcpServers": {
    "aleva": {
      "url": "https://api.aleva.se/mcp",
      "headers": {
        "Authorization": "Bearer alv_…"
      }
    }
  }
}

Svaren innehåller källa och licens. Visar du data från ett verktyg ska du ange källan på samma sätt som för API:et. Mer om svaren.

Verktyg

Två verktyg hjälper assistenten att hitta rätt: search_catalogue söker bland datamängderna och describe_endpoint beskriver fält, licens och hur färsk datan är. Sedan finns ett verktyg per endpoint:

VerktygVad det gerREST
airport_passengers Passagerare per flygplats och år /v1/aviation/airports
air_passengers_monthly Flygpassagerare i Sverige per månad /v1/aviation/passengers/monthly
court_rulings Publicerade domar och referat /v1/courts/rulings
court_rulings_by_court Avgöranden per domstol /v1/courts/rulings/by-court
domains_dropped Avregistrerade .se- och .nu-domäner ett visst datum /v1/domains/dropped
domains_expiring Domäner som snart blir lediga /v1/domains/expiring
domains_valuable Domäner som snart blir lediga, med värdepoäng /v1/domains/expiring/valuable
domain_lookup En domän i den senaste zonen /v1/domains/{name}
domains_new Nya .se- och .nu-domäner ett visst datum /v1/domains/new
debt_restructuring Ansökningar om skuldsanering per månad /v1/economy/debt-restructuring
debt_restructuring_by_age Skuldsanering per år och ålder /v1/economy/debt-restructuring/by-age
electricity_balance Elproduktion och elanvändning per år /v1/energy/electricity/balance
electricity_forecast Elproduktion per kraftslag med prognos /v1/energy/electricity/by-source
foods Livsmedel och näringsvärden per 100 g /v1/foods
job_ads Lediga jobb per dag /v1/jobs/ads
job_ads_national Lediga jobb i Sverige per dag /v1/jobs/ads/national
medicine_shortages Restnoterade läkemedel /v1/medicines/shortages
medicine_shortages_by_group Pågående restnoteringar per ATC-grupp /v1/medicines/shortages/by-group
medicine_shortages_monthly Nya restnoteringar per månad /v1/medicines/shortages/monthly
municipal_figures Nyckeltal per kommun och år (Kolada) /v1/municipalities/figures
municipal_figures_latest Nyckeltal per kommun, senaste året /v1/municipalities/figures/latest
riksbank_rates Styrränta och valutakurser per dag /v1/rates/riksbank
swestr Swestr per dag /v1/rates/swestr
party_agreement Hur ofta partierna röstar lika /v1/riksdag/party-agreement
party_attendance Voteringar och frånvaro per parti /v1/riksdag/party-attendance
stats_dnssec DNSSEC-andel per zon och dag /v1/stats/dnssec
stats_nameservers Namnserveroperatörer och marknadsandel /v1/stats/nameservers
consumer_prices Konsumentprisindex per månad /v1/sweden/cpi
house_prices Fastighetsprisindex för småhus /v1/sweden/house-prices
population Folkmängd per region och år /v1/sweden/population
population_latest Folkmängd senaste året och förändring /v1/sweden/population/latest
guest_nights Gästnätter per månad /v1/tourism/guest-nights
guest_nights_by_country Utländska gästnätter per land och år /v1/tourism/guest-nights/by-country
guest_nights_by_county Gästnätter per län och år /v1/tourism/guest-nights/by-county
train_punctuality Tågens punktlighet per station och dag /v1/trains/punctuality
train_punctuality_daily Tågens punktlighet i Sverige per dag /v1/trains/punctuality/daily
weather_history Väder per timme och station /v1/weather/history
weather_now Vädret just nu per SMHI-station /v1/weather/now