Summary
Wraps the free postcodes.io API to give Claude geographic tools for UK postcodes without requiring authentication. You get four operations: lookup a postcode for coordinates and administrative boundaries like region, district, ward, and constituency; find nearby postcodes sorted by distance; validate postcode format; or pull a random valid postcode. Useful when you need to resolve UK addresses to lat/long, check if user input is a real postcode, or build location aware features for UK users. Runs through Pipeworx's gateway, which can bundle this with 673+ other data sources if you need broader API access beyond postcodes.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
mcp-postcodes
Postcodes MCP — wraps postcodes.io UK postcode API (free, no auth)
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ 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 673+ 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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →