Tools (3)

search_nav_jobs
get_nav_job
report_feedback

search_nav_jobs

Search Norwegian job listings from NAV Arbeidsplassen.

NAV (Norwegian Labour and Welfare Administration) aggregates job listings
from employers across Norway. Results include job title, employer, location,
application deadline, and occupation categories.

Args:
query: Free-text search (e.g. 'utvikler', 'sykepleier', 'ingeniør').
county: County name in uppercase (e.g. 'OSLO', 'ROGALAND').
municipal: Municipality name in uppercase (e.g. 'OSLO', 'BERGEN').
size: Results per request (25 or 100, default 25).
offset: Number of results to skip (default 0).

Returns:
Object with jobs list, total count, size, and offset.

Parameter	Type	Required	Description
`query`	`any`	optional	Free-text search query for Norwegian job listings (e.g. 'utvikler', 'sykepleier', 'ingeniør').
`county`	`any`	optional	Norwegian county name in uppercase, e.g. 'OSLO', 'ROGALAND', 'VESTLAND', 'TRØNDELAG', 'NORDLAND', 'VESTFOLD OG TELEMARK'.
`municipal`	`any`	optional	Norwegian municipality name in uppercase, e.g. 'OSLO', 'BERGEN', 'TRONDHEIM', 'STAVANGER', 'TROMSØ'. Added to the free-text query for approximate location filtering.
`size`	`integer`	optional	Number of results — snapped to 25 or 100 (API constraint). Default 25. (default: 25)
`offset`	`integer`	optional	Number of results to skip for pagination (default 0). (default: 0)

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_nav_jobs",
    "arguments": {}
  }
}

get_nav_job

Get a single Norwegian job listing by its UUID from NAV Arbeidsplassen.

Returns the job listing including title, employer, location,
application deadline, and occupation categories.

Args:
uuid: UUID of the job listing.

Returns:
Job listing record, or {"error": "not_found"} if the UUID is unknown.

Parameter	Type	Required	Description
`uuid`	`string`	required	UUID of the job listing to retrieve.

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_nav_job",
    "arguments": {
      "uuid": "example"
    }
  }
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

JSON-RPC Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "report_feedback",
    "arguments": {
      "feedback": "example"
    }
  }
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/mcp/nav-jobs/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_nav_job", "arguments": {"uuid": "example"}}}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/nav-jobs/",
    headers={"Gnist-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "get_nav_job",
    "arguments": {
      "uuid": "example"
    }
  }
},
)
print(resp.json())