About postcodes
postcodes is an MCP server published by pipeworx-io in the Security category: postcodes MCP — wraps postcodes.io UK postcode API (free, no auth).
Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/pipeworx-io/mcp-postcodesThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
lookup_postcodeGet geographic details for a UK postcode (e.g., 'SW1A 1AA'). Returns coordinates, region, district, ward, and constituency.
Parameters not published.
nearest_postcodesFind nearby UK postcodes sorted by distance from a given postcode (e.g., 'SW1A 1AA'). Returns list with coordinates.
Parameters not published.
random_postcodeGet a random valid UK postcode with full geographic details. Returns coordinates, region, district, ward, and constituency.
Parameters not published.
validate_postcodeValidate a UK postcode format (e.g., 'SW1A 1AA'). Returns whether it's valid and format details.
Parameters not published.
Ask AI
Ask AI about postcodes
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
mcp-postcodes
Postcodes MCP — wraps postcodes.io UK postcode API (free, no auth)
Part of Pipeworx — an MCP gateway connecting AI agents to 250+ live data sources.
Tools
| Tool | Description |
|---|---|
lookup_postcode |
Get geographic details for a UK postcode (e.g., 'SW1A 1AA'). Returns coordinates, region, district, ward, and constituency. |
nearest_postcodes |
Find nearby UK postcodes sorted by distance from a given postcode (e.g., 'SW1A 1AA'). Returns list with coordinates. |
validate_postcode |
Validate a UK postcode format (e.g., 'SW1A 1AA'). Returns whether it's valid and format details. |
random_postcode |
Get a random valid UK postcode with full geographic details. Returns coordinates, region, district, ward, and constituency. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"postcodes": {
"url": "https://gateway.pipeworx.io/postcodes/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 250+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Postcodes data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.