Integration · Company data

Connect Claude & ChatGPT to Postcodes.io

Ask your AI where a UK postcode is and which areas it belongs to. It looks up postcodes with Postcodes.io and returns coordinates, local authority, ward, constituency, region and country. It can also find the nearest postcodes to a point, check whether an old postcode has been terminated and look up outward codes and places.

Connect Postcodes.io free

Free plan, no credit card. Takes about a minute.

Try asking

“Which local authority and constituency is SW1A 1AA in?”
The AI looks up the postcode and returns its local authority, ward, constituency, region and country.
“What are the coordinates of these 20 customer postcodes?”
It looks up each postcode and returns its latitude and longitude.
“Which postcode is nearest to 51.501, -0.142?”
It reverse geocodes the coordinates and lists the nearest postcodes, optionally within a radius in metres.

What your AI can do

Postcode lookup

Coordinates, local authority, ward, constituency, region and country for a UK postcode.

Nearby and reverse geocoding

Find postcodes near another postcode or near a latitude and longitude, or match a partial postcode.

Outcodes, places and changes

Look up outward codes, places from Ordnance Survey names data, terminated postcodes and Scottish Parliament constituencies.

“Is this old postcode on our mailing list still in use?”
It checks whether the postcode has been terminated and, if so, when.
“Which areas does the outward code M1 cover?”
It looks up the outward code and returns its approximate location and the districts it covers.
“Which Scottish Parliament constituency is this Edinburgh postcode in?”
It looks up the Scottish postcode and returns its Scottish Parliament constituency.

11 tools for Postcodes.io

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_postcodeVisible to othersCreate a new postcode. Search postcodes first to avoid duplicates. Has effects visible outside this system. API summary: Bulk Postcode Lookup.
get_placeGet a place (town, village, suburb) by its `place_code` from the Ordnance Survey names data.
list_nearest_postcodesList postcodes nearest to a given `postcode`.
list_placesList places. API summary: Retrieve a Random Place.
list_postcodesList postcodes. Optional filters: outcode. API summary: Get a Random Postcode.
lookup_outcodeLook up an outward code (the first half of a postcode, e.g. SW1A) in `outcode`: approximate location and the districts it covers.
lookup_postcodeLook up a UK postcode in `postcode`: coordinates, local authority, ward, constituency, region and country.
lookup_scottish_postcodeLook up a Scottish `postcode` for its Scottish Parliament constituency.
lookup_terminated_postcodeCheck whether a `postcode` has been terminated (no longer in use) and when.
search_placesSearch places. Use this to find existing places before creating a new place. API summary: Find a Place.
search_postcodesFind postcodes matching a partial postcode in `query`, or reverse geocode by passing `latitude` and `longitude` (with optional `radius` in metres) to get the nearest postcodes.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Postcodes.io from the app list.
2
Paste your key
No account or API key needed. Postcodes.io is a free, open-source UK postcode API, so you only pick the app in PipMCP to get your MCP link.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Postcodes.io?

It can look up a postcode, an outward code, a Scottish postcode or a place, find postcodes matching a partial postcode, reverse geocode a latitude and longitude, list the nearest postcodes and check whether a postcode has been terminated.

Does the AI see my Postcodes.io credentials?

There are none to see. Postcodes.io is a free, open-source API that needs no account or API key, so you do not paste anything into PipMCP. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on. All tools here only read public postcode data, so nothing is changed. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. Postcodes.io itself is a free, open-source API.

Does it return street addresses?

No. The tools return where a postcode is and which areas it belongs to, such as local authority, ward, constituency, region and country, plus coordinates. They do not list the individual addresses in a postcode.