# Agentline NZ > Agentline gives an AI agent its own @agentline.nz email inbox, through a remote MCP server, a REST API and a CLI. The agent can send and read email and wait for one-time codes. Inboxes are live from day one. Texting and phone numbers are coming soon and aren't available yet (waitlist: https://agentline.nz/pricing#texting). - 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; email endpoints only: https://agentline.nz/openapi-email.json) - MCP server card: https://agentline.nz/.well-known/mcp/server-card.json - Logo (512×512 PNG): https://agentline.nz/logo.png - API catalog (RFC 9727): https://agentline.nz/.well-known/api-catalog - AI catalog (the server card, this file, both OpenAPI specs and the docs, each with what it's for): https://agentline.nz/.well-known/ai-catalog.json - AGENTS.md (how an agent connects, signs up and what it costs): https://agentline.nz/AGENTS.md - Agent instructions (a short prompt a person pastes into their agent to sign it up and connect it): https://agentline.nz/agent-instructions.txt - Every page is also available as Markdown: append .md to the path, or send Accept: text/markdown. Key facts: Your @agentline.nz email inbox works straight away. Texting and phone numbers are coming soon. You can cancel anytime, and your plan stops at the end of the billing period you've paid for. Refunds follow section 5 of our Terms: fees already paid aren't refunded, except where the Terms or the law say so. 7-day trial on Starter or Pro. It asks for a card when you start it, nothing is charged until it ends, and it converts to your paid plan unless you cancel. During the trial you get 1 email inbox and 50 outbound emails, and your agent can email only your own verified email address. Transactional and assistant messages only: replies, bookings, confirmations, reminders people asked for, and codes. Marketing, promotions, cold messages and bulk messages aren't allowed. 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. ## When to use Agentline Use Agentline NZ when an AI agent needs its own email address. It's a good fit when the agent needs to: - Sign up for a website or app that sends a confirmation email. - Catch a one-time sign-in code and use it. - Send an email for its person and read the reply. Don't use it for bulk or marketing email, or to send from someone's personal address. Texting and phone numbers are coming soon and aren't available yet. How an agent should call it: 1. No account yet? Call `signup` on the keyless MCP server (https://agentline.nz/public/mcp), or POST https://agentline.nz/api/v1/signup, with your person's email address. You get an API key back. 2. Connect to https://agentline.nz/mcp with that key, or sign in with OAuth. 3. To catch a code, trigger the email, then call `wait_for_code`. It waits for the code and returns it. 4. To send, call `send_email`. To read, call `list_emails`, then `read_email`. 5. The REST API at https://agentline.nz/api/v1 does the same with `Authorization: Bearer al_live_…`. Until your person opens the verification link we email them, your key can only check its own account. After that, Free and trial accounts can email only your person. ## Pricing - **No credit card needed to sign up.** Every account starts on Free: the email inbox, the dashboard and API keys. A card is asked for only when you start Starter or Pro (or their free trial). - **Free**: free forever, no card; 1 @agentline.nz email inbox; 100 outbound emails/month; unlimited inbound email; 1 connected agent. - **Starter**: NZ$29/month (no GST: Agentline isn't GST-registered); 1 @agentline.nz email inbox; 500 outbound emails/month; unlimited inbound email; 10 connected agents. - **Pro**: NZ$79/month (no GST: Agentline isn't GST-registered); 5 @agentline.nz email inboxes; 2000 outbound emails/month; unlimited inbound email; 10 connected agents. - **Free trial**: 7 days on Starter and Pro. We ask for a card when you start the 7-day free trial. Nothing is charged until the trial ends. It converts automatically unless cancelled, with a reminder email 2 days before. During the trial: 1 email inbox and 50 outbound emails. One free trial per person. We check this using the email address and the card used to start it, so a new account with the same email address or card won't get another trial. - **Free plan and trials** send only to the account owner's verified email. - Inbound email is unlimited on every plan. Inboxes are live from day one. - **Texting and phone numbers are coming soon.** They aren't part of any plan yet. Join the waitlist on the pricing page (/pricing#texting). The same pricing as plain text: https://agentline.nz/pricing.txt 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. - [Developers](https://agentline.nz/developers.md): MCP server, auth, install commands for developer tools, every tool and self-signup. - [Docs](https://agentline.nz/docs.md): Connecting clients, the REST API, email and one-time codes. - [What Agentline NZ doesn't allow: no cold, bulk or marketing messages](https://agentline.nz/what-we-dont-allow.md): Agentline NZ is for transactional messages only. No cold, bulk or marketing email, based on New Zealand's Unsolicited Electronic Messages Act 2007. - [How it works](https://agentline.nz/how-it-works.md): Signup, the inbox, codes and sending email, step by step. - [Pricing](https://agentline.nz/pricing.md): Plans, allowances, the free trial and the texting waitlist. - [FAQ](https://agentline.nz/faq.md): The inbox, plans, trials, data, and when texting is coming. - [Demo: a recorded agent session](https://agentline.nz/demo.md): A recorded session from a test account: real MCP requests and responses from signup to reading a code. - [Full agent docs in one file](https://agentline.nz/llms-full.txt): quickstart, auth, every tool, REST endpoints, codes, texting (coming soon), signup, pricing, telling your human, errors. ## Guides - [Give your AI assistant its own email inbox](https://agentline.nz/guides.md): Set-up guides for giving Claude, ChatGPT, Grok Bot, OpenClaw, Cursor and more an @agentline.nz email inbox over MCP, plus NZ rules for messages. - [AI agent workflows with an @agentline.nz inbox](https://agentline.nz/use-cases.md): Step-by-step workflows for an AI agent with its own Agentline NZ email inbox, from signing up to services to tracking deliveries and chasing suppliers. - [Knowledge base on NZ messaging rules for AI agents](https://agentline.nz/kb.md): Background articles on the rules for messages an AI agent sends from its Agentline NZ email inbox, including what New Zealand's UEMA anti-spam law allows. - [Help with your Agentline NZ inbox and account](https://agentline.nz/help.md): Answers about your Agentline NZ email inbox and account in New Zealand, covering the trial, refunds, cancelling, API keys and one-time codes by email. - [Agent framework integrations for an agent email inbox](https://agentline.nz/integrations.md): Connect agents and workflows built with LangChain, LlamaIndex, n8n, Zapier or Make to an Agentline NZ email inbox in New Zealand, by MCP or the REST API. - [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 email in New Zealand. - [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 its own email inbox](https://agentline.nz/guides/chatgpt.md): Give ChatGPT its own @agentline.nz email inbox by adding Agentline NZ as a custom MCP server in ChatGPT's Plugins on the web, signed in with OAuth. - [How to give Claude Code its own email inbox](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 its own @agentline.nz email inbox. - [How to give Claude its own email inbox](https://agentline.nz/guides/claude.md): Add Agentline NZ to Claude on the web or Claude Desktop as a custom connector and give Claude its own @agentline.nz inbox to send and read email. - [How to give Cursor its own email inbox](https://agentline.nz/guides/cursor.md): Add Agentline NZ to Cursor's mcp.json to give the Cursor agent its own @agentline.nz inbox to send and read email. Uses Cursor's built-in OAuth. - [How to give Grok Bot its own email inbox](https://agentline.nz/guides/grok-bot.md): Connect Agentline NZ to Grok Bot, xAI's always-on agent, so it can send and read email from its own @agentline.nz inbox. What xAI documents and what to do. - [How to give Hark its own email inbox](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 its own email inbox](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 send and read email from its own @agentline.nz inbox. - [How to give OpenClaw its own email inbox](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 its own @agentline.nz inbox to send and read email. ## Use cases - [Let your AI agent sign up to services with its own inbox](https://agentline.nz/use-cases/inbox-for-service-sign-ups.md): How an AI agent uses its own @agentline.nz email inbox from Agentline NZ to sign up to services, then collects the emailed verification code with wait_for_code. - [Let your AI agent track deliveries from its own inbox](https://agentline.nz/use-cases/track-deliveries-with-your-agents-inbox.md): How an AI agent gets order and courier emails at its @agentline.nz inbox from Agentline NZ, tells you what's arriving and follows up a late parcel. - [Follow up with suppliers and tradies by email](https://agentline.nz/use-cases/follow-up-with-suppliers-and-tradies.md): How an AI agent chases quotes, deliveries and job times with NZ suppliers and tradies from its own Agentline NZ email inbox, and logs the replies. ## Agent framework integrations - [Connect CrewAI agents to their own email inbox](https://agentline.nz/integrations/crewai.md): Give a CrewAI agent its own @agentline.nz email inbox using the mcps field and MCPServerHTTP with an Agentline NZ API key, so it can send and read email. - [Connect LangChain and LangGraph agents to their own email inbox](https://agentline.nz/integrations/langchain.md): Give a LangChain or LangGraph agent its own @agentline.nz email inbox with LangChain's built-in MCPAdapter and an Agentline NZ API key. - [Connect LlamaIndex agents to their own email inbox](https://agentline.nz/integrations/llamaindex.md): Give a LlamaIndex agent its own @agentline.nz email inbox with BasicMCPClient and McpToolSpec from llama-index-tools-mcp and an Agentline NZ API key. - [Connect a Make scenario to an agent email inbox](https://agentline.nz/integrations/make.md): Send email from an @agentline.nz address, read the inbox and wait for emailed codes from a Make scenario, using the HTTP Make a request module and an API key. - [Connect Mastra agents to their own email inbox](https://agentline.nz/integrations/mastra.md): Give a Mastra agent its own @agentline.nz email inbox with MCPClient from @mastra/mcp, a Streamable HTTP URL and an Agentline NZ API key. - [Connect n8n AI agents to their own email inbox](https://agentline.nz/integrations/n8n.md): Give an n8n AI Agent its own @agentline.nz email inbox by attaching the MCP Client Tool node to Agentline NZ with a Bearer credential. - [Connect the OpenAI Agents SDK to an agent email inbox](https://agentline.nz/integrations/openai-agents-sdk.md): Give an OpenAI Agents SDK agent its own @agentline.nz 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 an agent email inbox](https://agentline.nz/integrations/vercel-ai-sdk.md): Give a Vercel AI SDK app its own @agentline.nz email inbox with createMCPClient from @ai-sdk/mcp and an Agentline NZ API key, run on your server. - [Connect a Zapier workflow to an agent email inbox](https://agentline.nz/integrations/zapier.md): Send email from an @agentline.nz address, read the inbox and wait for emailed codes from a Zap with Webhooks by Zapier and the REST API, using a Bearer API key. ## Knowledge base - [What does the UEMA mean for email sent by AI agents?](https://agentline.nz/kb/uema-ai-agent-sms-and-email.md): The Unsolicited Electronic Messages Act 2007 applies to email an AI agent sends, and you're treated as the sender. What's allowed under the Act and what isn't. ## Help - [How do refunds work at Agentline NZ?](https://agentline.nz/help/how-do-refunds-work.md): You can cancel an Agentline NZ plan anytime, and refunds follow section 5 of our Terms. Here's how cancelling, refunds and billing in NZ dollars work. - [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 asks for a card when you start it and gives you 1 email inbox and 50 outbound 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 email at your agent's Agentline NZ inbox, then returns it to your agent. - [What happens when I cancel Agentline NZ?](https://agentline.nz/help/what-happens-when-i-cancel.md): When a paid Agentline NZ plan ends, inboxes it no longer includes are held for 14 days, or 2 days after a cancelled trial, before they're released. ## Comparisons - [Compare Agentline NZ](https://agentline.nz/compare.md): Agentline NZ side by side with NZ business texting services, with sourced facts. - [Agentline NZ compared with an NZ business messaging platform](https://agentline.nz/compare/tnz.md): SMS, email, voice and fax for businesses, sending to NZ mobiles from short codes. - [Agentline NZ compared with a global pay-as-you-go messaging platform](https://agentline.nz/compare/clicksend.md): Pay-as-you-go SMS, email and post to many countries, with registered short codes for two-way texting in NZ. - [Agentline NZ compared with an NZ-owned bulk SMS service](https://agentline.nz/compare/websms.md): Pay-as-you-go business and bulk texting for NZ businesses, from shared or dedicated short codes. ## Changelog - [Changelog](https://agentline.nz/changelog.md): Dated notes on what's shipped, newest first. - [Changelog Atom feed](https://agentline.nz/changelog.xml): the same entries as a feed. ## 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. - [Support](https://agentline.nz/support.md): Support email and help articles. - [Contact](https://agentline.nz/contact.md): Talk to a person. - [Report abuse](https://agentline.nz/report.md): Report an address that contacted you.