# yepthere

yepthere provides an Australian address API backed by G-NAF, with address autocomplete, coordinates, postcode lookups, address parsing and available geographic boundaries. Use the HTTP API, connect an AI assistant through the hosted MCP server with an API key, or add the address autocomplete widget to a website.

## Docs
- [API reference](https://yepthere.au/docs): Requests, responses, authentication and errors.
- [OpenAPI](https://yepthere.au/openapi.json): The machine-readable HTTP API contract.
- [Status](https://yepthere.au/status): The current data release and service readiness.

## AI and MCP
- [MCP setup and tools](https://yepthere.au/docs/mcp): Claude Desktop, Claude Code and Cursor configuration, plus local stdio setup. Hosted endpoint `/mcp`: Streamable HTTP using POST with Authorization: Bearer YOUR_KEY; normal scopes, quotas and rate limits apply. No OAuth.
- [Address autocomplete widget](https://yepthere.au/widget): Script tag, field mapping, browser keys and a working demo.

## Integrations
- [Integration guides](https://yepthere.au/docs/integrations): Copyable examples for forms, websites, workflows and local clients.
- [Plain HTML](https://yepthere.au/docs/integrations#plain-html): Add labelled fields and this script.
- [React](https://yepthere.au/docs/integrations#react): This component calls fetch directly, waits 300 ms after typing and cancels stale requests.
- [Vue 3](https://yepthere.au/docs/integrations#vue): Load the widget before mounting Vue 3.5 or later.
- [Next.js](https://yepthere.au/docs/integrations#nextjs): Use an App Router route handler and the client component below.
- [WordPress and WooCommerce](https://yepthere.au/docs/integrations#wordpress-woocommerce): Save this 40-line file as wp-content/plugins/yepthere/yepthere.php and activate it.
- [Webflow](https://yepthere.au/docs/integrations#webflow): Set these field IDs in the Designer and paste this embed after your form.
- [HubSpot forms](https://yepthere.au/docs/integrations#hubspot): Use onFormReady with a legacy raw HTML form.
- [Squarespace and Wix](https://yepthere.au/docs/integrations#squarespace-wix): Use Squarespace footer code injection on a plan that supports scripts; confirm the selectors on your published form.
- [Zapier and Make](https://yepthere.au/docs/integrations#zapier-make): Add a Webhooks by Zapier GET step or Make HTTP request.
- [Spreadsheets](https://yepthere.au/docs/integrations#spreadsheets): In Google Sheets, open Extensions, Apps Script and save this function.
- [CSV clean-up](https://yepthere.au/docs/integrations#csv-clean-up): Jobs need an account key with jobs scope and configured storage.
- [AI assistants via MCP](https://yepthere.au/docs/integrations#mcp): Hosted: POST /mcp, Bearer key.
- [Server-side clients](https://yepthere.au/docs/integrations#server-side-clients): These MIT clients are vendored by copy; the packages are not published.

## Pricing
- [Pricing](https://yepthere.au/pricing): Compare every allowance, billing option and counting rule.
- [Free](https://yepthere.au/#pricing): Free, no card; 5,000 lookups, 100 parses and no CSV rows per key per UTC calendar month; 1 key per account; 5 requests a second per key.
- [Supporter](https://yepthere.au/#pricing): $5 a month; 10,000 lookups, 500 parses and no CSV rows per key per UTC calendar month; 2 keys per account; 10 requests a second per key.
- [Pro](https://yepthere.au/#pricing): $49 a month; 100,000 lookups, 10,000 parses and 100,000 CSV rows per key per UTC calendar month; 5 keys per account; 20 requests a second per key. Trial: 30 days.
- [Scale](https://yepthere.au/#pricing): $149 a month; 500,000 lookups, 50,000 parses and 500,000 CSV rows per key per UTC calendar month; 25 keys per account; 50 requests a second per key. Trial: 30 days.
- [Supporter, annual](https://yepthere.au/#pricing): $50 a year; 10,000 lookups, 500 parses and no CSV rows per key per UTC calendar month; 2 keys per account; 10 requests a second per key.
- [Pro, annual](https://yepthere.au/#pricing): $490 a year; 100,000 lookups, 10,000 parses and 100,000 CSV rows per key per UTC calendar month; 5 keys per account; 20 requests a second per key. Trial: 30 days.
- [Scale, annual](https://yepthere.au/#pricing): $1,490 a year; 500,000 lookups, 50,000 parses and 500,000 CSV rows per key per UTC calendar month; 25 keys per account; 50 requests a second per key. Trial: 30 days.
- [Keys and limits](https://yepthere.au/docs#limits): Scopes, browser restrictions, quota accounting and Retry-After.

## Policies
- [Usage policy](https://yepthere.au/usage-policy): Acceptable use and service terms.
- [Privacy](https://yepthere.au/privacy): Operator samples, request metadata and address parser processing.
- [Data and attribution](https://yepthere.au/docs#data): G-NAF licence and attribution, boundary sources and mailing list restrictions.