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.

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_io
Every 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/mcp
Set it up in your client

Both 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

    NameTypeRequired
    postcodestringYes

    Returns postcodes_ioLookup

    interface 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/lookup

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.postcodes_io.lookup("SW1A 1AA");

Use it from code