How do I use mcp-dawa?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-dawa search for addresses on Banegårdsgade in Aarhus" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-dawa

MCP server for DAWA — Danmarks Adressers Web API.

Provides address search and lookup tools via the Model Context Protocol.

Tools

Tool	Description
`search`	Free-text/phonetic address search (full addresses with floor/door)
`search_husnumre`	Free-text/phonetic house number search (without floor/door)
`detailed`	ID-based lookup of a specific address or house number

Quick start

# Clone and install
git clone https://github.com/itk-dev/mcp-dawa.git
cd mcp-dawa
uv sync --extra dev

# Run tests
uv run pytest

# Run locally
python -m mcp_dawa

# Run with Docker
docker compose --profile dev up --build

Configuration

Copy .env.example to .env. Available settings:

Variable	Default	Description
`DAWA_BASE_URL`	`https://adressevaelger.dk`	API base URL
`DAWA_TOKEN`	`adressevaelger123`	API token
`DAWA_KOMMUNEKODE`	`0751`	Default municipality code (0751 = Aarhus Kommune)

Development

Requires Python 3.11+ and uv.

# Install with dev dependencies
uv sync --extra dev

# Run tests
uv run pytest

# Docker dev (source mounted for live reload)
docker compose --profile dev up --build