Postcodes.io MCP server for AI agents
Let Claude, ChatGPT or your own agent read Postcodes.io: 1 typed function through one MCP server. No Postcodes.io API key needed.
- Site
- postcodes.io
- Functions
- 1
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Postcodes.io
An MCP server for Postcodes.io alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/postcodes_ioEvery site
One MCP server for Postcodes.io and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 1
lookupLook up a UK postcode: its latitude and longitude, OS grid eastings/northings, and the admin geography it sits in (ward, district, county, region…Arguments
Name Type Required postcodestringYes Returns
postcodes_ioLookupinterface postcodes_ioLookup { postcode: string; // canonical, "SW1A 1AA" latitude: number | null; longitude: number | null; eastings: number | null; // OS National Grid northings: number | null; country: string | null; // "England", "Scotland", … region: string | null; adminDistrict: string | null; adminCounty: string | null; adminWard: string | null; parish: string | null; parliamentaryConstituency: string | null; outcode: string | null; incode: string | null; quality: number | null; // 1 best … 9 no coordinates terminated: string | null; // "YYYYMM" when retired }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/postcodes_io/lookupCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.postcodes_io.lookup("SW1A 1AA");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.postcodes_io.lookup("SW1A 1AA"))curl -X POST https://api.bowmark.ai/v1/sites/postcodes_io/lookup \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"postcode":"SW1A 1AA"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.postcodes_io.lookup("SW1A 1AA");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/postcodes_io/<function> - OpenAPI
/v1/sites/postcodes_io/openapi.json