# 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[​](#prerequisite-get-an-api-key "Direct link to Prerequisite: Get an API key")

Sign up at [addresszen.com/signup](https://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[​](#skills "Direct link to Skills")

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

```
npx skills add addresszen/skills
```

Source: [github.com/addresszen/skills](https://github.com/addresszen/skills). The mirror is live; skills content is **coming soon**.

## llms.txt[​](#llmstxt "Direct link to llms.txt")

A single comprehensive file at [docs.addresszen.com/llms.txt](https://docs.addresszen.com/llms.txt) - full API reference, integration guides, code examples, formatted for LLMs. Follows the [llms.txt standard](https://llmstxt.org/).

Paste relevant sections into your model's context, or wire it into a docs MCP server like [Context 7](https://context7.com/).

## Markdown docs[​](#markdown-docs "Direct link to Markdown docs")

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

* [`/docs/address-lookup.md`](https://docs.addresszen.com/docs/address-lookup.md)
* [`/docs/api/find-address.md`](https://docs.addresszen.com/docs/api/find-address.md)
* [`/docs/integrations/magento.md`](https://docs.addresszen.com/docs/integrations/magento.md)

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

## AI builder integrations[​](#ai-builder-integrations "Direct link to 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[​](#starter-prompt "Direct link to 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[​](#builders "Direct link to Builders")

* **[v0](https://v0.app)** - Add `ADDRESSZEN_API_KEY` in the project's environment variables (Project Settings → Environment Variables) before sending the prompt.
* **[Bolt.new](https://bolt.new)** - Add the key to the generated `.env` file as `ADDRESSZEN_API_KEY`. Bolt's chat picks this up automatically.
* **[Lovable](https://lovable.dev)** - 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](https://replit.com)** - Add the key as a Repl Secret named `ADDRESSZEN_API_KEY`; access via `process.env.ADDRESSZEN_API_KEY`.
* **[base44](https://base44.com)** - Add the key in the project's environment variables panel.
* **[Leap.new](https://leap.new)** - Add the key as a project secret and pass it into the address-lookup constructor.

### Coding agents[​](#coding-agents "Direct link to Coding agents")

| Tool           | Setup                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------- |
| Claude Code    | `npx skills add addresszen/skills`                                                                |
| Cursor         | `npx skills add addresszen/skills`                                                                |
| Codex          | `npx skills add addresszen/skills`                                                                |
| Windsurf       | Add [llms.txt](https://docs.addresszen.com/llms.txt) as a context source                          |
| GitHub Copilot | Reference [llms.txt](https://docs.addresszen.com/llms.txt) from `.github/copilot-instructions.md` |

### shadcn[​](#shadcn "Direct link to shadcn")

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

## Need help?[​](#need-help "Direct link to Need help?")

* File an issue: [github.com/addresszen/feedback](https://github.com/addresszen/feedback/issues)
* Email: <support@addresszen.com>