Skip to main content

Build with AI

Everything an agent or AI builder needs to integrate AddressZen - agent skills, plain-text docs, and per-builder recipes.

Prerequisite: Get an API key​

Sign up at addresszen.com/signup to get an API Key. Want to do a quick test? Use our test, but highly rate limited API Key ak_test.

Skills​

Agent skills for Claude Code, Cursor, and Codex - install command:

npx skills add addresszen/skills

Source: github.com/addresszen/skills. The mirror is live; skills content is coming soon.

llms.txt​

A single comprehensive file at docs.addresszen.com/llms.txt - full API reference, integration guides, code examples, formatted for LLMs. Follows the llms.txt standard.

Paste relevant sections into your model's context, or wire it into a docs MCP server like Context 7.

Markdown docs​

Append .md to any docs URL for the plain-text version. Examples:

Useful when you want to feed one specific page into a model rather than the full llms.txt.

AI builder integrations​

Use AddressZen inside browser-based AI app builders. The integration is the same everywhere - install the widget, read the API key from a secret. Only the secret-storage step differs per builder.

Starter prompt​

Paste this into the builder's chat. Replace the secret line with the builder-specific instruction below.

Add international address autocomplete using AddressZen.

- Install `@addresszen/address-lookup` and mount it on the
  delivery / billing address fields.
- Reference docs: https://docs.addresszen.com/docs/address-lookup.md
- Read the API key from <BUILDER-SPECIFIC SECRET - see below>.

Builders​

  • v0 - Add ADDRESSZEN_API_KEY in the project's environment variables (Project Settings → Environment Variables) before sending the prompt.
  • Bolt.new - Add the key to the generated .env file as ADDRESSZEN_API_KEY. Bolt's chat picks this up automatically.
  • Lovable - Store the key as a Supabase secret (Lovable's recommended pattern for sensitive values). Reference it from the front end via a Supabase Edge Function.
  • Replit - Add the key as a Repl Secret named ADDRESSZEN_API_KEY; access via process.env.ADDRESSZEN_API_KEY.
  • base44 - Add the key in the project's environment variables panel.
  • Leap.new - Add the key as a project secret and pass it into the address-lookup constructor.

Coding agents​

ToolSetup
Claude Codenpx skills add addresszen/skills
Cursornpx skills add addresszen/skills
Codexnpx skills add addresszen/skills
WindsurfAdd llms.txt as a context source
GitHub CopilotReference llms.txt from .github/copilot-instructions.md

shadcn​

Drop-in <AddressLookup /> component for shadcn projects - coming soon.

Need help?​