# AGENTS.md: Agentline NZ

Agentline NZ gives an AI agent its own New Zealand 028 mobile number (two-way SMS, voice on Pro) and an @agentline.nz email inbox, over MCP and a REST API. The inbox works from day one; the 028 number is set up within a few days of signup.

## Connect

- MCP server (Streamable HTTP): https://agentline.nz/mcp
- Auth: OAuth 2.1 with PKCE. Discovery starts from the 401's `WWW-Authenticate` header, which points to https://agentline.nz/.well-known/oauth-protected-resource/mcp. Dynamic Client Registration (https://agentline.nz/oauth/register) and Client ID Metadata Documents are supported. Scopes: `messages:read` (needed by every read tool), `messages:send`, `offline_access`.
- Or an API key: `Authorization: Bearer al_live_…` on https://agentline.nz/mcp and https://agentline.nz/api/v1/*.
- Keyless MCP server (no credentials; read-only plus signup, can't send messages for you): https://agentline.nz/public/mcp
- REST API: https://agentline.nz/api/v1 (OpenAPI: https://agentline.nz/openapi.json)

## Sign yourself up

Call `signup` on https://agentline.nz/public/mcp (or `POST https://agentline.nz/api/v1/signup`) with `{"owner_email": "…"}` (`owner_mobile` and `agent_name` are optional). There's no approval step: you get an API key, an inbox and an MCP config in the response. We email your human a verification link. Until they open it, your key can only check its own account and can't send messages for you. After that, Free and trial accounts send only to the owner's verified email and mobile. A person adds a card to start a paid plan (`get_checkout_link` emails them a Stripe Checkout link).

## Plans

- **Free**: free forever, no card; 0 × NZ 028 numbers; 1 email inbox; 0 outbound SMS segments/month; 100 outbound emails/month; no voice; 1 connected agent.
- **Starter**: NZ$29/month (no GST: Agentline isn't GST-registered); 1 × NZ 028 number; 1 email inbox; 50 outbound SMS segments/month; 500 outbound emails/month; no voice; 10 connected agents.
- **Pro**: NZ$79/month (no GST: Agentline isn't GST-registered); 2 × NZ 028 numbers; 5 email inboxes; 200 outbound SMS segments/month; 2000 outbound emails/month; voice (200 min/month); 10 connected agents.
- **Free trial**: 7 days on Starter and Pro. Card required; converts automatically unless cancelled; reminder email 2 days before. During the trial: 1 NZ 028 number, 1 email inbox, 10 outbound SMS segments, 50 outbound emails and no voice minutes.
- **Free plan and trials** send only to the account owner's verified email and mobile.
- Inbound SMS and email are unlimited on every plan. Inboxes are live from day one; NZ 028 numbers are set up within a few days of signup, with a full refund if a number hasn't arrived within 30 days of your first payment.

## More

- [llms.txt](https://agentline.nz/llms.txt)
- [Docs](https://agentline.nz/docs)
- [MCP server card](https://agentline.nz/.well-known/mcp/server-card.json)
- [API catalog](https://agentline.nz/.well-known/api-catalog)