Ordnance Survey - MCP Server
About
A Python-based MCP server that provides access Ordnance Survey's APIs.
Details
- Author
- CHRISCARLON
- GitHub stars
- 2
- Downloads
- 238
- Categories
- Productivity
Jump to
- Access to UK geospatial data via OS APIs
- Natural‑language querying of locations and features
- Prompt templates for street works, planning, road networks
- Enforces a two‑step workflow plan for best results
- Runs locally via Docker with a single API key
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Ordnance Survey - MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Obtain a free API key from the OS Data Hub, then run the server via Docker. Add the following to your Claude Desktop configuration, replacing your_api_key_here with your key: a Docker command with environment variables OS_API_KEY and STDIO_KEY. After starting, tools, resources, and prompts are available in Claude Desktop.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ordnance survey - mcp server": {
"os-mcp": {
"command": "docker",
"args": [
"build",
"-t",
"os-mcp-server",
"."
]
}
}
}
}McpServers
{
"os-mcp": {
"command": "docker",
"args": [
"build",
"-t",
"os-mcp-server",
"."
]
}
}Ordnance Survey MCP Server
A MCP server for accessing UK geospatial data through Ordnance Survey APIs.
What it does
Provides LLM access to the Ordnance Survey's Data Hub APIs.
Ask simple questions such as find me all cinemas in Leeds City Centre or use the prompts templates for more complex, speciifc use cases - relating to street works, planning, etc.
Use the prompts templates for more complex, speciifc use cases - relating to road networks, etc.
This MCP server enforces a 2 step workflow plan to ensure the user gets the best results - it must always produce a plan before making searches.
Quick Start
1. Get an OS API Key
Register at OS Data Hub to get your free API key and set up a project.
2. Run with Docker and add to your Claude Desktop config (easiest)
Clone the repository:
git clone https://github.com/your-username/os-mcp-server.git
cd os-mcp-server
Then build the Docker image:
docker build -t os-mcp-server .
Add the following to your Claude Desktop config:
{
"mcpServers": {
"os-mcp-server": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"OS_API_KEY=your_api_key_here",
"-e",
"STDIO_KEY=any_value",
"os-mcp-server"
]
}
}
}
Open Claude Desktop and you show see all available tools, resources, and prompts.
License
MIT License. This project does not have the endorsement of Ordnance Survey. This is a personal project and not affiliated with Ordnance Survey. This is not a commercial product. It is actively being worked on so expect breaking changes and bugs.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
