Nationale Vacaturebank MCP Server

A Model Context Protocol (MCP) server that provides access to the Nationale Vacaturebank (National Job Bank) API for job searching and location services in the Netherlands.

Features

• Job Search: Search for job listings with advanced filtering options
• Function Titles: Search and autocomplete job function titles
• City Search: Find Dutch cities with prefix matching
• Geolocation: Get coordinates for Dutch cities
• MCP Integration: Seamless integration with Claude and other MCP clients

Available Tools

| Tool | Description | Parameters | |------|-------------|------------| | search_function_titles | Search job function titles | query (required) | | search_city | Search Dutch cities by prefix | startsWith (required) | | get_geolocation | Get city coordinates | cityName (required) | | find_jobs | Search job listings | city, jobTitle, latitude, longitude, distance, page, limit, sort |

Installation

Prerequisites

• Go 1.24.5 or later
• Access to the internet (for API calls)

Clone and Build

git clone https://github.com/voyagen/nationalevacaturebank-mcp-server.git
cd nationalevacaturebank-mcp-server
go mod download
go build -o bin/server ./cmd/server

Quick Start

# Run the MCP server
./bin/server

# Or run directly with Go
go run ./cmd/server

Configuration

The server can be configured using environment variables:

| Variable | Description | Default | |----------|-------------|---------| | NVB_BASE_URL | Nationale Vacaturebank API base URL | https://api.nationalevacaturebank.nl | | NVB_TIMEOUT | HTTP request timeout | 30s | | LOG_LEVEL | Logging level (info, debug, error) | info | | MAX_RETRIES | Maximum API retry attempts | 3 | | SERVER_NAME | MCP server name | Nationale Vacature Bank | | SERVER_VERSION | MCP server version | 1.0.0 |

Example Configuration

export NVB_TIMEOUT=45s
export LOG_LEVEL=debug
export MAX_RETRIES=5
./bin/server

Usage Examples

With Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "nationalevacaturebank": {
      "command": "/path/to/nationalevacaturebank-mcp-server/bin/server",
      "env": {
        "NVB_TIMEOUT": "30s",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Search for Frontend Developer Jobs

// Example MCP tool usage
const jobs = await callTool("find_jobs", {
  jobTitle: "frontend developer",
  city: "Amsterdam",
  limit: 10,
  sort: "relevance"
});

Get City Coordinates

// Get Amsterdam coordinates
const location = await callTool("get_geolocation", {
  cityName: "Amsterdam"
});
// Returns: { cityCenter: { latitude: 52.3676, longitude: 4.9041 }, cityName: "Amsterdam" }

Search Job Function Titles

// Search for developer-related functions
const functions = await callTool("search_function_titles", {
  query: "developer"
});
// Returns: { suggestions: ["Frontend Developer", "Backend Developer", "Full Stack Developer", ...] }

Architecture

The project follows Go best practices with a clean architecture:

├── cmd/server/           # Application entry point
├── internal/
│   ├── api/             # HTTP client and error handling
│   ├── config/          # Configuration management
│   ├── handlers/        # MCP tool handlers
│   └── server/          # MCP server setup
├── pkg/nvb/             # Public types and interfaces
└── bin/                 # Compiled binaries

Key Components

• API Client: Handles HTTP communication with Nationale Vacaturebank API

... View full README on GitHub