# Ideal Postcodes MCP by usefulapi

> Ideal Postcodes MCP by usefulapi is a freemium MCP server for naming and domains. Hosted MCP server for UK-style address lookup and email/phone checks via Ideal Postcodes. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/ideal-postcodes/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/ideal-postcodes
- **MCP Registry name:** io.usefulapi/ideal-postcodes
- **Categories:** [naming and domains](https://ai-powered.com/categories/naming-and-domains)
- **Listing updated:** 2026-11-19

## About

The README describes a hosted connector that lets an AI assistant query the Ideal Postcodes service using the user's own API key. It can turn a partial address into ranked suggestions and then resolve the chosen one, list addresses at a postcode, fetch an address by Royal Mail UDPRN, and check whether an email domain accepts mail or a phone number parses to a country format.

Setup happens through an OAuth login page rather than a key in client config, so the same URL works in Claude, ChatGPT, Cursor, VS Code and Codex. The page notes the server is run by usefulapi, an independent service not affiliated with Ideal Postcodes. Coverage is stated as the UK, Republic of Ireland, the Netherlands and Singapore.

The seven lookup and validation tools are marked read-only. A free tier allows 50 tool calls a month, with paid Pro and Pro+ plans for higher volumes billed through Stripe.

## Features

- **Partial address search:** Returns ranked address suggestions from a partial entry, then resolves the chosen one to a full address.
- **Postcode address listing:** Lists the addresses at a postcode one page at a time across the supported countries.
- **UDPRN lookup:** Fetches an address by its Royal Mail delivery point id, useful for checking whether a stored address still exists.
- **Email deliverability check:** Reports whether an email domain resolves and has mail records.
- **Phone number validation:** Returns the country and national and international formats for a number that includes a country code.
- **Usage and plan management:** Reports usage against the monthly limit and can start, change or cancel a paid subscription.

## Good for

- Autocomplete a UK or Irish postal address in an AI-assisted form or chat
- Refresh stored addresses by UDPRN to see whether they are still on the dataset
- Check that customer email addresses have a domain that can receive mail
- Normalise phone numbers into national and international formats before storing them

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ideal-postcodes https://ideal-postcodes.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://ideal-postcodes.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ideal-postcodes": {
      "url": "https://ideal-postcodes.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ideal-postcodes": {
      "type": "http",
      "url": "https://ideal-postcodes.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ideal-postcodes": {
      "serverUrl": "https://ideal-postcodes.usefulapi.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://ideal-postcodes.usefulapi.io/mcp
```

Enter a Name (for example "Ideal Postcodes MCP by usefulapi"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ideal-postcodes": {
      "type": "http",
      "url": "https://ideal-postcodes.usefulapi.io/mcp"
    }
  }
}
```

## Tools

All 7 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `idealpostcodes_lookup_postcode` (says read-only): Return the addresses at a postcode (UK, Republic of Ireland, Netherlands, Singapore), one page at a time: page 0 holds almost every postcode, and the reply gives total. Each page costs one lookup, and an empty result is free. For a form that picks an address, prefer the find and resolve tools. Ideal Postcodes API: GET /postcodes/{postcode}.
- `idealpostcodes_find_address` (says read-only): Return ranked address suggestions for a partial address (typeahead). Each suggestion has an id for idealpostcodes_resolve_address. This step is free. Ideal Postcodes API: GET /autocomplete/addresses.
- `idealpostcodes_resolve_address` (says read-only): Return the full address for a suggestion id from idealpostcodes_find_address. Costs one lookup. Ideal Postcodes API: GET /autocomplete/addresses/{address}/gbr.
- `idealpostcodes_get_udprn` (says read-only): Return the address for a UDPRN (8-digit Royal Mail delivery point id). Use it to refresh a stored address or to test whether it still exists (404 = not on the dataset). Costs one lookup. Ideal Postcodes API: GET /udprn/{udprn}.
- `idealpostcodes_key_status` (says read-only): Show whether this account's API key can be used now (available), and the search contexts the key is licensed for. Free, and it shows no account data beyond the key status. Ideal Postcodes API: GET /keys/{key}.
- `idealpostcodes_validate_email` (says read-only): Check whether an email address is deliverable (domain resolves and has mail records). Costs one lookup when the domain is checked; 'unknown' results are free. Ideal Postcodes API: GET /emails.
- `idealpostcodes_validate_phone_number` (says read-only): Check a phone number and return its country and its national and international formats. The number needs a country code. Every query costs one lookup, also for an invalid number. Ideal Postcodes API: GET /phone_numbers.

## FAQ

### Is this an official Ideal Postcodes product?

No. The page says usefulapi is an independent service and is not affiliated with or endorsed by Ideal Postcodes. It calls the Ideal Postcodes API with the user's own access.

### Do I put my API key in the client config?

No. The README says to add only the server URL. The server signs the user in with OAuth, and the login page asks for the Ideal Postcodes API key.

### Which countries are covered?

The page lists postcode lookup for the UK, Republic of Ireland, the Netherlands and Singapore.

### What does the free plan allow?

The pricing table lists 50 tool calls per month on the Free plan, with Pro at 10,000 and Pro+ at 100,000 calls per month.

### Is Ideal Postcodes MCP by usefulapi free?

Ideal Postcodes MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Ideal Postcodes MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http ideal-postcodes https://ideal-postcodes.usefulapi.io/mcp

### What are the best alternatives to Ideal Postcodes MCP by usefulapi?

The closest alternatives to Ideal Postcodes MCP by usefulapi are Domain availability and quotes (demo), Eclipse Namesake, domaroo, HugeDomains: premium domain names for sale and Renameproof.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Domain availability and quotes (demo)](https://ai-powered.com/mcp/domain-availability-and-quotes-demo): Domain availability and quotes (demo) is a free MCP server for naming and domains.
- [Eclipse Namesake](https://ai-powered.com/mcp/eclipse-namesake): Eclipse Namesake is an open-source MCP server for agent identity.
- [domaroo](https://ai-powered.com/mcp/domaroo): domaroo is a free MCP server for naming and domains.
- [HugeDomains: premium domain names for sale](https://ai-powered.com/mcp/hugedomains-premium-domain-names-for-sale): HugeDomains: premium domain names for sale is an MCP server for naming and domains.
- [Renameproof](https://ai-powered.com/mcp/renameproof): Renameproof is a freemium MCP server for naming and domains.
- [Brand Name Check](https://ai-powered.com/mcp/brand-name-check): Brand Name Check is a freemium MCP server for naming and domains.
- [Stake](https://ai-powered.com/mcp/stake): Stake is a free MCP server for naming and domains.
- [Host.al: .al domains and servers in Albania](https://ai-powered.com/mcp/host-al-al-domains-and-servers-in-albania): Host.al: .al domains and servers in Albania is a free MCP server for naming and domains.

---
Source: https://ai-powered.com/mcp/ideal-postcodes-mcp-by-usefulapi
