Developers

# Agentline NZ for developers

Connect Agentline NZ to Cursor, VS Code, Claude Code, Codex or any MCP client, and your agent gets its own @agentline.nz email inbox.

For AI assistants and developers: [llms.txt](https://agentline.nz/llms.txt) · [llms-full.txt](https://agentline.nz/llms-full.txt) · [/agents](https://agentline.nz/agents) · [OpenAPI](https://agentline.nz/openapi.json) · [server card](https://agentline.nz/.well-known/mcp/server-card.json) · [/kb](https://agentline.nz/kb) · [/help](https://agentline.nz/help) · [/integrations](https://agentline.nz/integrations)

## mcp

- server https://agentline.nz/mcp
- transport streamable-http
- auth oauth2.1 (CIMD, DCR) | bearer al_live_…
- keyless https://agentline.nz/public/mcp
- registry nz.agentline/agentline-nz

## first calls

- signup // no account yet
- get_my_number // inbox, plan, limits
- wait_for_code // email OTP, 55s

## read me

- [/llms.txt](https://agentline.nz/llms.txt) · [/llms-full.txt](https://agentline.nz/llms-full.txt)
- [/.well-known/mcp/server-card.json](https://agentline.nz/.well-known/mcp/server-card.json)
- [/openapi.json](https://agentline.nz/openapi.json) · [/index.md](https://agentline.nz/index.md)
- [/kb](https://agentline.nz/kb) · [/help](https://agentline.nz/help) · [/integrations](https://agentline.nz/integrations)

Connect

## Add Agentline NZ to your MCP client

MCP server `https://agentline.nz/mcp` (Streamable HTTP, OAuth or API key). MCP Registry: `nz.agentline/agentline-nz`. You sign in to Agentline the first time a tool needs it.

### Cursor

Click Add to Cursor and confirm the install prompt.

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=agentline&config=eyJ1cmwiOiJodHRwczovL2FnZW50bGluZS5uei9tY3AifQ%3D%3D)[All steps for Cursor](https://agentline.nz/install#cursor)

### VS Code (GitHub Copilot)

Click Add to VS Code. If VS Code doesn't open, see [other ways to install](https://agentline.nz/install#vscode).

[Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22agentline%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fagentline.nz%2Fmcp%22%7D)[All steps for VS Code (GitHub Copilot)](https://agentline.nz/install#vscode)

### Claude (claude.ai and Claude Desktop)

Click Add to Claude. Claude opens the Add custom connector dialog with the name and URL filled in.

[Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Agentline&connectorUrl=https%3A%2F%2Fagentline.nz%2Fmcp)[All steps for Claude (claude.ai and Claude Desktop)](https://agentline.nz/install#claude)

### Claude Code

Run the command, then type /mcp in Claude Code and choose agentline → Authenticate.

```
claude mcp add --transport http agentline https://agentline.nz/mcp
```

[All steps for Claude Code](https://agentline.nz/install#claude-code)

### Codex CLI

Run the command; codex mcp login opens the Agentline sign-in.

```
codex mcp add agentline --url https://agentline.nz/mcp && codex mcp login agentline
```

[All steps for Codex CLI](https://agentline.nz/install#codex)

### ChatGPT

In ChatGPT, go to Plugins, select the plus button, then Add custom MCP server (account and workspace policies apply).

[All steps for ChatGPT](https://agentline.nz/install#chatgpt)

[Windsurf, Cline, Goose, Zed, Gemini CLI, n8n and any other MCP client →](https://agentline.nz/install)

What your agent gets

## A real identity your agent can use, with guardrails built in

### wait_for_code

One call waits for a one-time code to arrive by email and hands it back, up to 55 s. No polling loop to write.

### Every major agent

One-click installs for Claude, Cursor, VS Code and Goose; one-line installs for Claude Code, Codex and Gemini CLI.

### Email in and out

Send from your agent's @agentline.nz address and read what arrives, through MCP, the REST API or the CLI.

### Safe by default

Spam and phishing checks, rate limits and a full audit log. Built for NZ's anti-spam law.

Texting and phone numbers are coming soon. [Join the waitlist](https://agentline.nz/pricing#texting).

Tools

## What you can call

Authenticated server: `https://agentline.nz/mcp`. Every tool is annotated read-only or not, and anything that sends needs the `messages:send` scope.

| Tool | Scope | What it does |
| --- | --- | --- |
| get_my_number | read | Your inbox(es), plan, allowances and any sending restriction. Call first. |
| wait_for_code | read | Wait up to 55s for a one-time code to arrive in your inbox; each code returned once. |
| send_email | send | Email from your @agentline.nz address (up to 5 recipients). |
| list_emails | read | Recent emails, newest first (filter by direction, unread_only, since). |
| read_email | read | Full email text by id. Reading never changes read state. |
| mark_read | read | Mark emails read (or unread with read=false), up to 100 ids. |
| list_api_keys | read | API keys (prefix, name, last used). |
| create_api_key | send | New API key; secret shown once. |
| revoke_api_key | send | Revoke a key (destructive). |
| list_audit_log | read | Recent account events. |
| get_billing | read | Plan, status, trial end, allowances. |
| get_checkout_link | send | Stripe Checkout link to start a plan, emailed to the owner and returned. |
| get_billing_portal_link | send | Stripe Customer Portal link (card, plan, cancel), also emailed to the owner. |
| get_profile | read | Which account is connected. |
| send_sms | send | Send a text. Coming soon: texting isn't available yet. |
| list_messages | read | List texts. Coming soon: texting isn't available yet. |
| read_message | read | Read one text. Coming soon: texting isn't available yet. |
| list_calls | read | List calls. Coming soon: calls aren't available yet. |
| get_voice_settings | read | Call settings. Coming soon: calls aren't available yet. |
| update_voice_settings | send | Change call settings. Coming soon: calls aren't available yet. |
| start_owner_phone_verification | send | Verify the owner's mobile. Coming soon: texting isn't available yet. |
| verify_owner | send | Confirm the owner's mobile with a code. Coming soon: texting isn't available yet. |

No account yet

## Sign yourself up

The keyless server `https://agentline.nz/public/mcp` needs no credentials and can't send anything for you. Its tools: `get_pricing`, `check_number_availability`, `get_docs`, `get_install_instructions`, `signup`.

You get an API key, an inbox and an MCP config straight away, with no approval step. We email your human a verification link; until they click it, you can message only them. Free and trial accounts send only to the owner's verified email.

The full agent docs, including a summary to pass on to your human, are at [/agents](https://agentline.nz/agents).

```
curl -X POST https://agentline.nz/api/v1/signup \
  -H 'Content-Type: application/json' \
  -d '{"owner_email":"you@example.nz","agent_name":"Ari"}'
```