Model Context Protocol

Politipuls MCP

Leseorientert tilgang til norske politihendelser og aggregater fra Politiloggen. Endepunktet krever ingen autentisering og støtter ti verktøy over Streamable HTTP.

Trenger du rådata direkte fra kilden? Se guiden til Politiloggen API.

Endepunkt: https://politipuls.no/api/mcp
Protokoll: 2025-11-25
Tidssone: Europe/Oslo

Omfang og sannhetsgrenser

Hendelsesdata er read-only. MCP-serveren kan ikke endre, opprette eller slette politihendelser.
Transporten oppretter kortlivede sesjoner og rate-limit-tellere. Dette er driftsmetadata, ikke endringer i hendelsesdata.
Kilden er Politiloggen. Gjenbruk skjer under NLOD 2.0 med attribusjon til Politiet.
Politipuls er en uavhengig tjeneste og er ikke tilknyttet Politiet eller en nødetat.
Dette er ikke en nødkanal. Ring 112 ved akutt fare.

Koble til

Send JSON-RPC 2.0 til https://politipuls.no/api/mcp. Serveren svarer påinitialize med headeren MCP-Session-Id. Bruk samme header i resten av sesjonen. Send også den forhandlede protokollversjonen i MCP-Protocol-Version på etterfølgende kall. Eldre klienter uten denne headeren bruker versjonen som allerede er lagret i sesjonen; en annen verdi avvises.

Vanlige MCP-klienter kobler til fra en server eller lokal prosess og påvirkes ikke av nettleser-CORS. Nettleserkall støttes bare fra Politipuls sine egne origins og lokale Capacitor-origins. Avslutt en sesjon med DELETE, MCP-Session-Id ogContent-Type: application/json. Innholdstypen kreves også når DELETE-kallet ikke har en body, fordi Astro sin globale CSRF-port ellers avviser forespørselen før MCP-ruten.

1. Initialiser

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "eksempel-klient",
      "version": "1.0.0"
    }
  }
}

2. Bekreft initialisering
Send denne notifikasjonen med MCP-Session-Id fra første svar:
```
{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}
```

3. List verktøy

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

Tilgjengelige verktøy

Denne listen rendres fra det samme manifestet som brukes av tools/list og discovery-endepunktene.

list_incidents

List recent Politipuls incidents, including authoritative GeoJSON and separate display-anchor semantics when available, with optional district, category, municipality, and active-only filters.

Input-schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100
    },
    "district": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "municipality": {
      "type": "string"
    },
    "activeOnly": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

get_incident

Fetch one Politipuls incident by id, including authoritative GeoJSON and separate display-anchor semantics when available.

Input-schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

get_incident_messages

Fetch the timeline messages for one Politipuls incident.

Input-schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

get_filter_options

Fetch available districts, municipalities, and categories for Politipuls filtering.

Input-schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

aggregate_by_category

Count incidents grouped by category. Use this for category bar/pie charts. Returns rows ordered by count desc.

Input-schema

{
  "type": "object",
  "properties": {
    "timeRange": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d",
        "180d",
        "365d",
        "all"
      ]
    },
    "district": {
      "type": "string"
    },
    "municipality": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

aggregate_by_district

Count incidents grouped by district. Use this for district leaderboards or maps. Returns rows ordered by count desc.

Input-schema

{
  "type": "object",
  "properties": {
    "timeRange": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d",
        "180d",
        "365d",
        "all"
      ]
    },
    "category": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

top_municipalities

Top N municipalities by incident count. Optional district filter. Use for ranking visualizations.

Input-schema

{
  "type": "object",
  "properties": {
    "timeRange": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d",
        "180d",
        "365d",
        "all"
      ]
    },
    "district": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

time_series

Time-bucketed incident counts (daily, weekly, or monthly) from nightly pre-aggregated stats. Use for trend lines and time-series charts. Optional district/category filter. Time-series buckets are materialized nightly. Each query selects one canonical aggregation level so incidents are not double-counted. Later source edits, removals, and the currently open bucket can cause a small difference from live incident aggregates over nominally similar periods.

Input-schema

{
  "type": "object",
  "properties": {
    "granularity": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ]
    },
    "days": {
      "type": "number",
      "enum": [
        7,
        14,
        30,
        60,
        90,
        180,
        365
      ]
    },
    "district": {
      "type": "string"
    },
    "category": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

incidents_in_bbox

List incidents with documented physical points within a geographic bounding box, including authoritative GeoJSON when available. Incidents represented only by a technical anchor or non-point geometry abstain rather than being treated as point hits. north/south are latitudes, east/west are longitudes.

Input-schema

{
  "type": "object",
  "properties": {
    "north": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "south": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "east": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "west": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "timeRange": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d",
        "90d",
        "180d",
        "365d",
        "all"
      ]
    },
    "category": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "north",
    "south",
    "east",
    "west"
  ],
  "additionalProperties": false
}

category_trends

Month-over-month trend per (district, category) — current vs previous month with percent change. Use for trend dashboards.

Input-schema

{
  "type": "object",
  "properties": {
    "district": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

Sesjon og rate limits

Sesjonslevetid: 3600 sekunder, glidende ved gyldige kall.
Initialize: 60 kall per 60 sekunder per IP-adresse.
Verktøykall: 600 kall per 60 sekunder per MCP-sesjon.
Rate-limit-feil: JSON-RPC-kode -32099.

Discovery

https://politipuls.no/.well-known/api-catalog — API Catalog-linkset.
https://politipuls.no/.well-known/mcp/server-card.json — eksperimentelt, versjonert MCP Server Card.
https://politipuls.no/llms.txt — kort agentkontekst.
https://politipuls.no/api/health — driftsstatus.

Databegrensninger

Politipuls is independent and is not an official police or emergency service.
Locations are derived from public incident text and may be approximate or absent.
Incidents can be delayed, corrected, deactivated, or removed by the source.
Time-series buckets are materialized nightly. Each query selects one canonical aggregation level so incidents are not double-counted. Later source edits, removals, and the currently open bucket can cause a small difference from live incident aggregates over nominally similar periods.
The endpoint does not support SSE or MCP resources and prompts.

Results reflect the latest successfully ingested Politiloggen snapshot; delays and later source edits can occur.

Omfang og sannhetsgrenser

Koble til

1. Initialiser

2. Bekreft initialisering

3. List verktøy

Tilgjengelige verktøy

list_incidents

get_incident

get_incident_messages

get_filter_options

aggregate_by_category

aggregate_by_district

top_municipalities

time_series

incidents_in_bbox

category_trends

Sesjon og rate limits

Discovery

Databegrensninger