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:
| Verktyg | Vad det ger | REST |
|---|---|---|
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 |