# AI Assist

Drop AddressZen into any AI workflow, from coding agents driving a repo to chat-driven app builders generating a frontend.

## Prerequisite: API key

* **Quick test:** use `ak_test`. Public, capped at 5 lookups/day, will break in production.
* **Real testing:** [sign up](https://account.addresszen.com/users/sign_up) for a free trial key with a real test balance.
* **Lock it down before going live:** restrict the key to your origin via [Allowed URLs](/docs/guides/allowed-urls.md).

## Resources

Ordered by what an agent should reach for first.

* **[llms.txt](https://docs.addresszen.com/llms.txt)**: full API reference, integration guides, and widget docs as one file. Paste into a model's context, or wire into a docs MCP server like [Context7](https://context7.com/).
* **MCP server**: **coming soon.** Will surface API docs, dataset metadata, and key management as MCP tools.
* **Agent skills**: **coming soon.** A dedicated skills package for Claude Code, Cursor, and Codex.
* **CLI**: **coming soon.** Built for agents: JSON output in non-TTY, stable exit codes. Use a backend key (no Allowed URLs).
* **[Address Lookup](/docs/address-lookup.md)**: international address autocomplete widget.
* **Per-page markdown**: append `.md` to any docs URL for the plain-text version (e.g. [`/docs/address-lookup.md`](https://docs.addresszen.com/docs/address-lookup.md)).

## AI builder guides

Per-platform setup, prompts, and key-storage instructions live in [Build with AI integrations](/docs/integrations/build-with-ai.md).

### Coding Agents

* [Claude Code](/docs/integrations/claude-code.md)
* [Cursor](/docs/integrations/cursor.md)
* [Codex](/docs/integrations/codex.md)
* [Windsurf](/docs/integrations/windsurf.md)
* [GitHub Copilot](/docs/integrations/github-copilot.md)

### AI App Builders

* [Lovable](/docs/integrations/lovable.md)
* [Bolt](/docs/integrations/bolt.md)
* [v0](/docs/integrations/v0.md)
* [Replit](/docs/integrations/replit.md)
* [base44](/docs/integrations/base44.md)
* [Leap.new](/docs/integrations/leap-new.md)
* [shadcn registry](/docs/integrations/shadcn.md): coming soon

## Need help?

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