# Give your AI assistant a NZ phone number, SMS and email

**Short answer:** Agentline NZ gives an AI assistant its own New Zealand 028 phone number, two-way SMS and an @agentline.nz email inbox through one MCP server at https://agentline.nz/mcp, so it can text people, handle their replies and run its own email. Pick your assistant below for step-by-step setup checked against its official docs.

Starter is NZ$29/month and Pro is NZ$79/month. Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number. Your 028 number is set up within a few days of signup. Your email inbox works straight away. Full refund if your number hasn't arrived within 30 days of paying. Agentline NZ is not GST-registered, so no GST is charged.

## Pick your assistant

- [How to give Claude a phone number, text and email in New Zealand](/guides/claude)
- [How to give Claude Code a phone number, text and email in New Zealand](/guides/claude-code)
- [How to give ChatGPT and Dots a phone number, text and email in New Zealand](/guides/chatgpt)
- [How to give Grok Bot a phone number, text and email in New Zealand](/guides/grok-bot)
- [How to give OpenClaw a phone number, text and email in New Zealand](/guides/openclaw)
- [How to give Hermes Agent a phone number, text and email in New Zealand](/guides/hermes)
- [How to give Hark a phone number, text and email in New Zealand](/guides/hark)
- [How to give Cursor a phone number, text and email in New Zealand](/guides/cursor)

## Which assistants can add a custom MCP server

We read each assistant's official documentation on 17 October 2026 and recorded whether you can add a custom remote MCP server, how, and on which plans. "Partly verified" means at least one detail came from a page we couldn't fully load or from third-party sources, and is flagged on that guide.

| Assistant | Custom MCP server? | How you add Agentline NZ | Sign-in | Plans that can add it | Usable from NZ? | Checked |
|---|---|---|---|---|---|---|
| [Claude (web and desktop)](/guides/claude) | Yes | Customize > Connectors → + Add → Add custom connector | OAuth | Free (1 connector), Pro, Max, Team, Enterprise | Yes | verified |
| [Claude Code](/guides/claude-code) | Yes | claude mcp add --transport http | OAuth or API key header | Any plan with Claude Code | Yes | verified |
| [ChatGPT and Dots](/guides/chatgpt) | Yes | Plugins → + → Add custom MCP server; Dots: Customize → Plugins | OAuth | Business, Enterprise, Edu (full); Pro (read only) | Yes | verified |
| [Grok Bot](/guides/grok-bot) | Yes | Ask the Bot: Add this MCP server | OAuth | Paid Cursor plan or SuperGrok | Yes | partly verified |
| [OpenClaw](/guides/openclaw) | Yes | Settings → MCP → Add server, or openclaw mcp add | OAuth or API key header | Free, open source | Yes | verified |
| [Hermes Agent](/guides/hermes) | Yes | hermes mcp add --url, or config.yaml mcp_servers | OAuth or API key header | Free, open source | Yes | verified |
| [Hark](/guides/hark) | MCP mentioned, not documented | Unofficial: ask Hark in chat | API key header (reported) | Free, Pro², Pro³ | Unconfirmed | partly verified |
| [Cursor](/guides/cursor) | Yes | mcp.json with url | OAuth or API key header | Any plan (admins can allowlist) | Yes | verified |

MCP features change often. Each guide lists the documentation it was checked against and the date.

## What your assistant gets

| | Starter | Pro |
|---|---|---|
| Price | NZ$29/month | NZ$79/month |
| NZ 028 numbers | 1 | 2 |
| @agentline.nz inboxes | 1 | 5 |
| Outbound SMS segments a month | 50 | 200 |
| Outbound emails a month | 500 | 2000 |
| Voice minutes a month | None | 200 |
| Inbound SMS and email | Unlimited | Unlimited |

Every connected assistant gets the same tools: `get_my_number`, `send_sms`, `list_messages`, `read_message`, `send_email`, `list_emails`, `read_email`, `wait_for_code`, `list_calls` and `get_profile`. 7-day trial on Starter or Pro. Card up front, and it converts to your paid plan unless you cancel. During the trial you get 1 number, 1 inbox, 10 SMS segments, 50 emails and no voice minutes, and messages go only to your own verified email and mobile.

## Building your own agent?

Use the REST API or point your framework's MCP client at `https://agentline.nz/mcp` with an API key.

- [Connect CrewAI agents to a NZ phone number, SMS and email](/integrations/crewai)
- [Connect LangChain and LangGraph agents to a NZ phone number, SMS and email](/integrations/langchain)
- [Connect Mastra agents to a NZ phone number, SMS and email](/integrations/mastra)
- [Connect n8n AI agents to a NZ phone number, SMS and email](/integrations/n8n)
- [Connect the OpenAI Agents SDK to a NZ phone number, SMS and email](/integrations/openai-agents-sdk)
- [Connect OpenClaw to Agentline NZ with an API key](/integrations/openclaw)
- [Connect the Vercel AI SDK to a NZ phone number, SMS and email](/integrations/vercel-ai-sdk)

## NZ numbers and messaging rules

- [What's the difference between 028 and 021 numbers in New Zealand?](/kb/028-vs-021-numbers)
- [Can an AI agent receive SMS verification codes in New Zealand?](/kb/can-an-ai-agent-receive-sms-verification-codes-in-nz)
- [What does the UEMA mean for SMS and email sent by AI agents?](/kb/uema-ai-agent-sms-and-email)

## FAQ

### Is it legal for an AI agent to send texts in New Zealand?

Yes, within the Unsolicited Electronic Messages Act 2007. The Act bans unsolicited commercial electronic messages with a New Zealand link (s 9), and it covers texts as well as email. Messages that confirm a transaction the person agreed to, give factual account information or provide a quote they asked for are not commercial electronic messages (s 6(b)). Agentline NZ is built for those transactional messages only, and you are the sender of everything your agent sends. See [What does the UEMA mean for SMS and email sent by AI agents?](/kb/uema-ai-agent-sms-and-email).

### What counts as a commercial electronic message?

Under s 6 of the Act, it's a message that markets or promotes goods, services, land or a business or investment opportunity, or links to one that does. The Department of Internal Affairs says a single message can count as spam.

### What consent does the Act require?

Consent can be express (the person said yes), inferred from your relationship and conduct, or deemed when a business address is published conspicuously and the message relates to that person's role (s 4). The sender has to prove consent (s 9(3)).

### What must a commercial text include?

It must clearly identify who authorised it and how to contact them (s 10), and include a free, working unsubscribe that works by replying the same way (s 11). An unsubscribe takes effect 5 working days after it's used (s 9(2)).

### Who enforces the anti-spam law and what are the penalties?

The Department of Internal Affairs enforces the Act. Courts can order pecuniary penalties of up to $200,000 for an individual and $500,000 for an organisation (s 45). You can report spam texts free by forwarding them to 7726.

### Can Agentline NZ be used to send marketing texts?

No. Marketing, promotions, cold texts and bulk texts are blocked. Transactional and assistant messages only: replies, bookings, confirmations, reminders people asked for, and codes. See [What we don't allow](/what-we-dont-allow).

### What is an 028 number?

It's part of New Zealand's 02x mobile number range. The 028 range is split into small blocks held by many carriers and service providers rather than one network. Agentline NZ's numbers are 028 business messaging numbers that text standard NZ mobiles. See [What’s the difference between 028 and 021 numbers?](/kb/028-vs-021-numbers).

### How do I write an 028 number in international format?

Drop the leading 0 and add +64, so 028 X XXX XXXX becomes +64 28 X XXX XXXX.

### Can my assistant text landlines or overseas numbers?

No. Standard NZ mobile numbers only (020–029). No landlines, short codes, premium or international numbers.

### Which assistants can use Agentline NZ from New Zealand today?

Claude, Claude Code, ChatGPT and Dots, OpenClaw, Hermes Agent and Cursor document a way to add a custom MCP server, and it works from New Zealand. Grok Bot supports custom MCP servers, with setup described by Cursor staff rather than xAI's docs. Hark mentions MCP but doesn't document a setup yet.

### How long until my assistant has a number?

Your 028 number is set up within a few days of signup. Your email inbox works straight away. Full refund if your number hasn't arrived within 30 days of paying.

## Help

- [How do refunds work at Agentline NZ?](/help/how-do-refunds-work)
- [How long does it take to get my Agentline NZ number?](/help/how-long-does-it-take-to-get-my-number)
- [How are SMS segments counted on Agentline NZ?](/help/how-sms-segments-are-counted)
- [How does the Agentline NZ trial work?](/help/how-the-trial-works)
- [How do I create an Agentline NZ API key?](/help/how-to-create-an-api-key)
- [How does wait_for_code get one-time codes for my agent?](/help/how-wait-for-code-works)
- [What happens to my number when I cancel Agentline NZ?](/help/what-happens-when-i-cancel)
- [What happens when my AI assistant sends a text?](/help/what-happens-when-my-assistant-sends-a-text)
- [Who can my agent text and email with Agentline NZ?](/help/who-can-my-agent-text)
- [Why does my text say sent instead of delivered?](/help/why-does-my-text-say-sent-not-delivered)
- [What we don't allow](/what-we-dont-allow)

[Start free](https://agentline.nz/signup) · Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number.

## More guides for agents and developers

- [How to give an AI agent a New Zealand phone number](https://agentline.nz/guides/give-ai-agent-nz-phone-number.md): The quickest way to give ChatGPT, Claude or your own agent a real NZ mobile number for two-way SMS, and what to check first.
- [Can ChatGPT receive SMS verification codes?](https://agentline.nz/guides/chatgpt-receive-sms-verification-codes.md): How to let ChatGPT read one-time codes sent by SMS or email, how Agentline handles codes in ChatGPT, and which services may refuse.
- [Connect Claude to SMS and email with an MCP connector](https://agentline.nz/guides/connect-claude-sms-email-mcp.md): Add Agentline to claude.ai, Claude Desktop or Claude Code so Claude can text NZ mobiles, read replies and use its own inbox.
- [Why NZ business texting uses 028 numbers](https://agentline.nz/guides/why-nz-028-numbers.md): Why two-way texting from software in New Zealand runs on 028 business messaging numbers rather than ordinary 021 or 022 mobiles.
- [Give your AI agent its own email inbox](https://agentline.nz/guides/ai-agent-email-inbox.md): Why an agent should have its own address, how an @agentline.nz inbox works over MCP, and how the free plan fits in.
- [What the NZ Unsolicited Electronic Messages Act means for AI agents](https://agentline.nz/guides/nz-uema-ai-agents.md): A plain-English summary of the UEMA 2007 for anyone letting an AI agent send texts or emails in New Zealand.
- [Add SMS and email tools to Cursor, VS Code and Claude Code](https://agentline.nz/guides/add-sms-to-cursor-vscode-claude-code.md): One-click and one-line installs for Agentline's remote MCP server in developer tools, with OAuth or an API key.
- [How an AI agent can sign itself up for Agentline](https://agentline.nz/guides/agent-self-signup.md): Agents create their own Agentline account in one call with their human's email. No approval step. Here's what you get and what's restricted.
