Traktamente

You can query and explore Swedish per diem rates from Skatteverket through a fast, type-safe MCP server. It lets you look up rates by country, year, or country code, search across all countries, and use a hosted remote service or run it locally in development or production.

How to use

Connect to the MCP server using your MCP client and pick one of the available transport options. You can run the server locally for development or use the hosted service for quick access.

How to install

Prerequisites: you need Bun installed and a compatible MCP client. Bun handles runtime, dependencies, and development commands.

Install the MCP server package using Bun or pnpm.

# Install locally
bun add traktamente-mcp

# Or using pnpm
pnpm install traktamente-mcp

Configuration and usage

You have two ways to connect to the MCP server: a remote hosted service or a local development/server instance.

Remote hosted service (HTTP transport) provides a ready-to-use endpoint. You can add it to your Claude Code settings or use the provided CLI to register the MCP server.

Claude Code configuration (HTTP) example to connect to the remote service:

{
  "mcpServers": {
    "traktamente": {
      "transport": "http",
      "url": "https://traktamente.app/mcp"
    }
  }
}

Standalone usage (local server)

Run the server locally in various modes. The following commands assume you have Bun installed and are in the project directory where traktamente-mcp is available.

# Start the server (production-like run)
bun start

# Development mode with hot reload
bun dev

# Test with MCP Inspector (interactive web UI)
bun run inspector

With Docker

If you prefer containerized deployment, you can build and run a Docker image. Use the provided image name traktamente-mcp for local testing or production workflows.

# Build the Docker image
docker build -t traktamente-mcp .

# Run with stdio transport (interactive)
docker run -i traktamente-mcp

# Or use Docker Compose
# docker-compose up

Claude Desktop integration (Docker/CLI options)

To use the MCP server within Claude Desktop, you can configure the client to start the server as a background process or via Docker as needed.

{
  "mcpServers": {
    "traktamente": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "traktamente-mcp"]}
  }
}

Available tools (functions)

This MCP server provides three main tools to work with per diem data.

Tools

• get_traktamente — Query traktamente rates with optional filters like country, year, and country code.

• get_all_countries — List all available countries with data.

• search_traktamente — Search for countries using a regex pattern.

Available tools

get_traktamente

Query per diem rates with filters for country, year, and country code.

get_all_countries

List all countries with available per diem data.

search_traktamente

Search for countries using a regex pattern.