About Postcodes UK MCP Server
Postcodes UK MCP Server connects MCP clients to postcodes.io for UK postcode validation, lookup, and geographic searches. It supports both single and bulk lookups as well as nearest-postcode searches by coordinates.
Key features
- 01Validate UK postcodes
- 02Retrieve postcode details
- 03Look up postcodes in bulk
- 04Find nearby postcodes by coordinates
Use cases
- 01Check a UK postcode before using it
- 02Retrieve details for one or many postcodes
- 03Find postcodes near latitude and longitude coordinates
MCP support
It exposes UK postcode validation, lookup, bulk lookup, and nearest-postcode searches to MCP clients, using postcodes.io.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEPostcodes UK MCP Server
Overview
Postcodes UK MCP Server provides an efficient way to interact with the UK Postcodes API (postcodes.io). It offers validation, lookup, and geographical search capabilities for UK postcodes.
Features
- Validate UK postcodes
- Retrieve postcode details
- Bulk postcode lookup
- Find nearest postcodes by coordinates
Dependencies
- Python 3.8+
mcp-cli&httpx
Installation Steps
1. Install uv with official standalone installer:
For macOS and Linux
$ curl -LsSf https://astral.sh/uv/install.sh | sh
For Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex
2. Clone the repo
Then add MCP to your project dependencies:
uv add "mcp[cli]"
3. Make sure Claude Desktop App installed from Claude
4. Now install the Postcodes UK MCP Server to the Claude Desktop
mcp install postcodes.py
You will see the output like this after successful installation
INFO Added server 'postcodes' to Claude config claude.py:129
INFO Successfully installed postcodes in Claude app cli.py:467
Usage
The server provides multiple methods to interact with UK postcode data:
- Lookup details for a single postcode
- Perform bulk postcode lookups
- Find nearest postcodes by geographic coordinates
Demo on Claude Desktop:
API Endpoints
| Endpoint | Description |
|---|---|
/lookup/{postcode} | Retrieve details for a single postcode |
/bulk-lookup | Look up multiple postcodes at once |
/nearest?lat={lat}&lon={lon} | Find nearest postcodes based on coordinates |
📌 Contributing
Contributions are welcome! Feel free to submit issues or pull requests.
📄 License
This project is licensed under the MIT License.
⭐ Support
If you find this project useful, please ⭐ star the repository! and Find me in LinkedIn
Developed with ❤️ for UK postcode services.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.