Skip to main content

Claude Code

Drop our agent skills into Claude Code so the model knows how to wire up Address Finder, Postcode Lookup, the API and the CLI without trial-and-error.

Install​

One command, from inside your repo:

npx skills add ideal-postcodes/skills

This installs five skills under .claude/skills/:

  • ideal-postcodes-address-finder: multi-country address autocomplete widget
  • ideal-postcodes-postcode-lookup: UK postcode → address dropdown
  • ideal-postcodes-api-integration: direct HTTP integration
  • ideal-postcodes-react: React bindings for the widgets
  • ideal-postcodes-cli: non-interactive CLI for account, key and address operations

Skills load automatically when Claude Code opens the repo.

Verify​

Ask Claude Code:

What's the npm install command for the Ideal Postcodes Address Finder?

The skill should produce @ideal-postcodes/address-finder without prompting you to search the web.

API key​

  • Quick test: ak_test (capped at 5 lookups/day, public, breaks in production).
  • Real key: sign up for a free trial balance.
  • Before deploy: restrict the key via Allowed URLs.

Connect the MCP server​

Skills teach Claude Code to write integration code. To let it look up addresses, emails and phone numbers itself while it works, connect the MCP server with a backend key (no Allowed URLs):

claude mcp add --transport http ideal-postcodes https://api.ideal-postcodes.co.uk/mcp \
--header "Authorization: Bearer $IDEAL_POSTCODES_API_KEY"

Each tool call bills as the API endpoint it mirrors.

Going deeper​

Need help?​