# Agentline NZ > Agentline gives an AI agent its own New Zealand 028 mobile number (two-way SMS, voice on Pro) and an @agentline.nz email inbox, through a remote MCP server and a REST API. Inboxes are live from day one; NZ 028 numbers are set up within a few days of signup. - Authenticated MCP server (Streamable HTTP, OAuth 2.1 or API key): https://agentline.nz/mcp - Keyless MCP server (read-only plus signup; nothing can send for you): https://agentline.nz/public/mcp - REST API: https://agentline.nz/api/v1 (OpenAPI: https://agentline.nz/openapi.json) - MCP server card: https://agentline.nz/.well-known/mcp/server-card.json - Every page is also available as Markdown: append .md to the path, or send Accept: text/markdown. Key facts: 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. 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. Transactional and assistant messages only: replies, bookings, confirmations, reminders people asked for, and codes. Marketing, promotions, cold texts and bulk texts are blocked. No account? An agent can call signup on the keyless server (or POST https://agentline.nz/api/v1/signup) with its human's email and get an API key, inbox and MCP config in one call. We email the human a verification link. Opening it gives the agent's key full use of the account; until then the agent can't message anyone. Free and trial accounts send only to the owner's verified email and mobile. ## Pricing - **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 paying. A person approves paid plans. If yours asks what Agentline is or costs, a ready-to-relay summary is at https://agentline.nz/agents#human (also `pitchForHuman` from the keyless get_pricing tool). ## Docs - [For agents](https://agentline.nz/agents.md): Machine-readable overview: MCP endpoints, tools, auth and self-signup. - [Install](https://agentline.nz/install.md): One-click and one-line installs for Claude, ChatGPT, Cursor, VS Code and more. - [Docs](https://agentline.nz/docs.md): Connecting clients, the REST API, one-time codes and SMS rules. - [What Agentline NZ doesn't allow: no cold, bulk or marketing texts](https://agentline.nz/what-we-dont-allow.md): Agentline NZ is for transactional texts and email only. No cold, bulk or marketing messages, based on New Zealand's Unsolicited Electronic Messages Act 2007. - [How it works](https://agentline.nz/how-it-works.md): Signup, numbers, codes and sending, step by step. - [Pricing](https://agentline.nz/pricing.md): Plans, allowances, the free trial and the refund promise. - [FAQ](https://agentline.nz/faq.md): Numbers, SMS rules, trials, refunds, data and voice. - [Full agent docs in one file](https://agentline.nz/llms-full.txt): quickstart, auth, every tool, REST endpoints, codes, SMS rules, signup, pricing, telling your human, errors. ## Guides - [Give your AI assistant a NZ phone number, SMS and email](https://agentline.nz/guides.md): Set-up guides for adding a NZ 028 number, two-way SMS and an email inbox to Claude, ChatGPT, Grok Bot, OpenClaw, Cursor and more, plus NZ SMS rules. - [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. ## Assistant setup guides - [How to give ChatGPT and Dots a phone number, text and email in New Zealand](https://agentline.nz/guides/chatgpt.md): Connect ChatGPT and your ChatGPT Dots to a NZ 028 number, two-way SMS and an email inbox by adding Agentline NZ as a custom MCP server in Plugins. - [How to give Claude Code a phone number, text and email in New Zealand](https://agentline.nz/guides/claude-code.md): Add Agentline NZ to Claude Code with one claude mcp add command, sign in with /mcp, and give your coding agent a NZ 028 number and an email inbox. - [How to give Claude a phone number, text and email in New Zealand](https://agentline.nz/guides/claude.md): Add Agentline NZ to Claude on the web or Claude Desktop as a custom connector and give Claude a NZ 028 number, two-way SMS and an email inbox. - [How to give Cursor a phone number, text and email in New Zealand](https://agentline.nz/guides/cursor.md): Add Agentline NZ to Cursor's mcp.json to give the Cursor agent a NZ 028 number, two-way SMS and an email inbox. Uses Cursor's built-in OAuth. - [How to give Grok Bot a phone number, text and email in New Zealand](https://agentline.nz/guides/grok-bot.md): Connect Agentline NZ to Grok Bot, xAI's always-on agent, so it can text from a NZ 028 number and run its own email inbox. What xAI documents and what to do. - [How to give Hark a phone number, text and email in New Zealand](https://agentline.nz/guides/hark.md): Hark says it uses MCP but doesn't yet document how to add a custom MCP server. What we know, what to try with Agentline NZ, and what works today. - [How to give Hermes Agent a phone number, text and email in New Zealand](https://agentline.nz/guides/hermes.md): Add Agentline NZ to Nous Research's Hermes Agent with hermes mcp add or config.yaml, so Hermes can text from a NZ 028 number and use an email inbox. - [How to give OpenClaw a phone number, text and email in New Zealand](https://agentline.nz/guides/openclaw.md): Add Agentline NZ to OpenClaw from Settings → MCP or the openclaw mcp CLI so your self-hosted agent gets a NZ 028 number, two-way SMS and an email inbox. ## Agent framework integrations - [Connect CrewAI agents to a NZ phone number, SMS and email](https://agentline.nz/integrations/crewai.md): Give a CrewAI agent a NZ 028 number, two-way SMS and an @agentline.nz inbox using the mcps field and MCPServerHTTP with an Agentline NZ API key. - [Connect LangChain and LangGraph agents to a NZ phone number, SMS and email](https://agentline.nz/integrations/langchain.md): Give a LangChain or LangGraph agent a NZ 028 number, two-way SMS and an email inbox with LangChain's built-in MCPAdapter and an Agentline NZ API key. - [Connect Mastra agents to a NZ phone number, SMS and email](https://agentline.nz/integrations/mastra.md): Give a Mastra agent a NZ 028 number, two-way SMS and an email inbox with MCPClient from @mastra/mcp, a Streamable HTTP URL and an Agentline NZ API key. - [Connect n8n AI agents to a NZ phone number, SMS and email](https://agentline.nz/integrations/n8n.md): Give an n8n AI Agent a NZ 028 number, two-way SMS and an email inbox by attaching the MCP Client Tool node to Agentline NZ with a Bearer credential. - [Connect the OpenAI Agents SDK to a NZ phone number, SMS and email](https://agentline.nz/integrations/openai-agents-sdk.md): Give an OpenAI Agents SDK agent a NZ 028 number, two-way SMS and an email inbox by connecting MCPServerStreamableHttp to Agentline NZ with an API key. - [Connect OpenClaw to Agentline NZ with an API key](https://agentline.nz/integrations/openclaw.md): Configure OpenClaw's mcp.servers to reach Agentline NZ over Streamable HTTP with an API key from an environment variable, for unattended self-hosted agents. - [Connect the Vercel AI SDK to a NZ phone number, SMS and email](https://agentline.nz/integrations/vercel-ai-sdk.md): Give a Vercel AI SDK app a NZ 028 number, two-way SMS and an email inbox with createMCPClient from @ai-sdk/mcp and an Agentline NZ API key. ## Knowledge base - [What's the difference between 028 and 021 numbers in New Zealand?](https://agentline.nz/kb/028-vs-021-numbers.md): 028 and 021 are both NZ mobile-range numbers. 021 blocks are held by One New Zealand, while 028 is split into small blocks held by many carriers and providers. - [Can an AI agent receive SMS verification codes in New Zealand?](https://agentline.nz/kb/can-an-ai-agent-receive-sms-verification-codes-in-nz.md): Yes, if the agent has its own NZ number. How an Agentline NZ 028 number receives verification codes for your agent, and the limits to know about. - [What does the UEMA mean for SMS and email sent by AI agents?](https://agentline.nz/kb/uema-ai-agent-sms-and-email.md): The Unsolicited Electronic Messages Act 2007 applies to texts and email an AI agent sends, and you're treated as the sender. What's allowed and what isn't. ## Help - [How do refunds work at Agentline NZ?](https://agentline.nz/help/how-do-refunds-work.md): If your Agentline NZ 028 number hasn't arrived within 30 days of paying, you get a full refund. Here's how that works and how billing works otherwise. - [How long does it take to get my Agentline NZ number?](https://agentline.nz/help/how-long-does-it-take-to-get-my-number.md): Your Agentline NZ 028 number is set up within days and your inbox works straight away. No number within 30 days of paying means a full refund. - [How are SMS segments counted on Agentline NZ?](https://agentline.nz/help/how-sms-segments-are-counted.md): Agentline NZ counts outbound SMS in segments the way carriers bill them, 160 characters each or 70 with emoji or macrons. Here's how it affects your allowance. - [How does the Agentline NZ trial work?](https://agentline.nz/help/how-the-trial-works.md): The Agentline NZ 7-day trial of Starter or Pro takes a card up front and gives you 1 number, 1 inbox, 10 SMS and 50 emails, sent only to you. - [How do I create an Agentline NZ API key?](https://agentline.nz/help/how-to-create-an-api-key.md): Create an Agentline NZ API key under Dashboard → API keys and send it as a Bearer token to the REST API or MCP server. Keep it secret; revoke unused keys. - [How does wait_for_code get one-time codes for my agent?](https://agentline.nz/help/how-wait-for-code-works.md): wait_for_code waits up to 55 seconds for a one-time passcode to arrive by SMS or email at your Agentline NZ number or inbox, then returns it to your agent. - [What happens to my number when I cancel Agentline NZ?](https://agentline.nz/help/what-happens-when-i-cancel.md): When a paid Agentline NZ plan ends, your 028 number is held for 14 days, or 2 days after a cancelled trial, then released. Released numbers can't come back. - [What happens when my AI assistant sends a text?](https://agentline.nz/help/what-happens-when-my-assistant-sends-a-text.md): When your assistant texts through Agentline NZ, the message is checked for spam and marketing, rate-limited, logged and sent from your NZ 028 number. - [Who can my agent text and email with Agentline NZ?](https://agentline.nz/help/who-can-my-agent-text.md): Agentline NZ texts standard NZ mobiles only, for transactional messages people expect. Trial accounts can only message their owner's verified email and mobile. - [Why does my text say sent instead of delivered?](https://agentline.nz/help/why-does-my-text-say-sent-not-delivered.md): Agentline NZ's NZ carrier doesn't return delivery receipts, so texts show as sent, not delivered. Here's how to confirm a message arrived. ## Optional - [NZ compliance](https://agentline.nz/compliance.md): How Agentline applies the Unsolicited Electronic Messages Act 2007. - [Privacy policy](https://agentline.nz/privacy.md): What we store, where, and for how long. - [Terms of service](https://agentline.nz/terms.md): Plans, trials, refunds and acceptable use. - [Contact](https://agentline.nz/contact.md): Talk to a person. - [Report abuse](https://agentline.nz/report.md): Report a number or address that contacted you.