Provides access to Ordnance Survey Data Hub APIs and guided planning for geospatial queries.
Configuration
View docs{
"mcpServers": {
"os_mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"OS_API_KEY=your_api_key_here",
"-e",
"STDIO_KEY=any_value",
"os-mcp-server"
],
"env": {
"OS_API_KEY": "your_api_key_here",
"STDIO_KEY": "any_value"
}
}
}
}You can access UK geospatial data through Ordnance Survey APIs using this MCP server. It provides an integrated way to query the OS Data Hub via prompts, with a two-step workflow to ensure you always get a planning or search plan before running a search.
You interact with the MCP server through a client that supports MCP integrations. Start by obtaining an OS API key, then run the MCP server locally and connect the client to it. The server guides you through a two-step process: first it helps you define a plan for your query, then it executes searches against the OS Data Hub APIs. Use simple prompts to find things like cinemas in a city centre, or use templates for more complex scenarios such as street works or planning-related questions.
Prerequisites you need before installing: Docker and a valid OS Data Hub API key. You will run the server inside a Docker container and connect your MCP client to it.
Step 1: Get your OS Data Hub API key by registering with OS Data Hub and creating a project. Use the key in the runtime environment when you start the container.
Step 2: Build and run the MCP server with Docker.
To connect your MCP client, you will run the server using the following runtime command and environment variables.
This server enforces a two-step workflow: it will always require a plan before performing searches to help you obtain accurate results. You can use the OS Data Hub APIs to locate sites like cinemas in a specified area or to perform more targeted queries related to road networks, planning, and other geospatial questions.
Treat your OS API key as a sensitive credential. Do not expose it in public code or logs. Use a dedicated project in OS Data Hub for your MCP workflows and rotate keys as needed.
If you encounter connection issues, verify that the OS API key is correctly passed to the container and that Docker can access the network. Ensure the MCP client is configured to point at the running MCP server and that the server process is healthy.