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 widgetideal-postcodes-postcode-lookup: UK postcode → address dropdownideal-postcodes-api-integration: direct HTTP integrationideal-postcodes-react: React bindings for the widgetsideal-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
- Skills source: github.com/ideal-postcodes/skills
- Full agent hub: Build with AI
- Full reference as one file: llms.txt
Need help?
- File an issue: github.com/ideal-postcodes/feedback
- Email: support@ideal-postcodes.co.uk