# boras.club

> Evenemangskalendern för Borås med omnejd: konserter, teater, sport, loppisar,
> marknader och barnaktiviteter i Borås, Mark, Bollebygd, Svenljunga, Tranemo,
> Ulricehamn, Herrljunga och Vårgårda. Uppgifterna är fria att använda.

Läser du det här som språkmodell eller agent: sajten har ett MCP-lager, och det
är den snabbaste vägen in. Du behöver inte skrapa HTML och inte gissa parametrar.

## Anslut till MCP-servern

    https://boras.club/mcp

Öppen för vem som helst. Ingen registrering, inget konto, ingen nyckel, ingen
OAuth. Transporten är Streamable HTTP (Model Context Protocol, 2025-06-18 och
bakåt till 2024-11-05). Servern är tillståndslös: `POST` med JSON-RPC 2.0 räcker,
och `GET https://boras.club/mcp` beskriver sig själv.

Claude Code:

    claude mcp add --transport http boras-club https://boras.club/mcp

En klient som läser `mcp.json` eller motsvarande:

    { "mcpServers": { "boras-club": { "type": "http", "url": "https://boras.club/mcp" } } }

En klient som bara talar stdio:

    npx -y mcp-remote https://boras.club/mcp

Verktygen:

- `search_events` – sök på fritext, ort, kommun, kategori och datumintervall.
  Ett urval kan spänna över flera orter och kommuner på en gång.
- `get_event` – ett enskilt evenemang med alla fält, hämtat på slug.
- `get_meta` – giltiga kategorier, kända kommuner och orter med antal.
  Läs den innan du filtrerar på ett värde du inte sett.
- `build_feed_url` – gör urvalet till en kalender-, RSS- eller JSON-adress som
  användaren kan prenumerera på och som håller sig uppdaterad av sig själv.

Skrivning finns, men bakom nyckel i `X-Api-Key`. Utan nyckel listas inte
skrivverktygen – det du ser är hela det öppna lagret.

## Om du hellre hämtar över HTTP

Samma urval finns som vanligt REST-API, om MCP inte passar:

- [/api/v1](https://boras.club/api/v1): självbeskrivande index över adresser, parametrar och exempel.
- [/api/v1/events](https://boras.club/api/v1/events): JSON. Filter: `place`, `city`, `category`, `q`, `from`, `to`, `scope`, `limit`, `offset`, `sort`.
- [/api/v1/events.ics](https://boras.club/api/v1/events.ics): iCalendar, för prenumeration i kalenderappen.
- [/api/v1/events.rss](https://boras.club/api/v1/events.rss): RSS 2.0.
- [/api/v1/meta](https://boras.club/api/v1/meta): kategorier, kommuner, orter.

## Sidor

- [Startsidan](https://boras.club/): kommande evenemang, som lista eller karta.
- [Arkivet](https://boras.club/arkiv): passerade evenemang, månad för månad.
- [Ett evenemang](https://boras.club/evenemang/): en sida per evenemang, `/evenemang/<slug>`.
- [Sitemap](https://boras.club/sitemap.xml): alla sidor, byggd ur databasen vid varje anrop.

## Så här vill vi bli använda

Uppgifterna är fria att använda, återge och bygga vidare på. Två saker ber vi om:
ange boras.club som källa, och länka till evenemangets egen sida (fältet `url`)
så att läsaren kan kontrollera uppgiften och se om något ändrats.

Tider är ISO 8601 i svensk tidszon. Är `end` null har arrangören inte uppgett
någon sluttid; `end_estimated` är då vår uppskattning utifrån kategorin, inte ett
besked från arrangören – presentera den aldrig som om den vore det. Ett pris utan
`amount` är ett pris vi inte känner, inte ett gratisevenemang.

Kalendern uppdateras löpande. Cacha gärna, men inte längre än ett dygn, och
kontrollera datum och tid mot källan innan någon planerar sin kväll efter dem.

## In English

boras.club is the local events calendar for Borås, Sweden, and the surrounding
municipalities. It exposes a public, keyless MCP server at
`https://boras.club/mcp` (Streamable HTTP) with four read tools, plus a plain
REST API at `https://boras.club/api/v1` serving JSON, iCalendar and RSS. The tool
and field descriptions are in Swedish because the data is. Free to use; credit
boras.club and link to the event's own `url`.