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 NZ 028 number and @agentline.nz inbox.

For AI assistants and developers: llms.txt · llms-full.txt · /agents · OpenAPI · server card · /kb · /help · /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 // number, inbox, limits
wait_for_code // SMS or email OTP, 55s

read me

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 All steps

VS Code (GitHub Copilot)

Click Add to VS Code. If VS Code doesn't open, see other ways to install.

Add to VS Code All steps

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 All steps

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

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

ChatGPT

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

All steps

Windsurf, Cline, Goose, Zed, Gemini CLI, n8n and any other MCP client →

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 by SMS or 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.

Voice on Pro

Forward calls to a SIP or ElevenLabs voice agent, a wss:// stream or a phone, play a greeting, or take voicemail with transcription.

Safe by default

Transactional SMS only, STOP handling, spam and phishing checks, rate limits and a full audit log. Built for NZ's anti-spam law.

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 number(s), inbox(es), plan, allowances and any sending restriction. Call first.
wait_for_code	read	Wait up to 55s for a one-time code by SMS or email; each code returned once.
send_sms	send	Text a NZ mobile from your number. Transactional only; marketing is blocked.
list_messages	read	Recent SMS, newest first (filter by direction, contact, unread_only, since).
read_message	read	One SMS by id.
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 SMS and emails read (or unread with read=false), up to 100 ids.
list_calls	read	Calls and voicemail transcripts.
get_voice_settings	read	Call handling for each number.
update_voice_settings	send	Replace call handling: greeting/voicemail, or forward to SIP (e.g. ElevenLabs), wss:// stream or a phone.
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).
start_owner_phone_verification	send	Get a code the owner texts from their mobile to verify it (replaces any verified mobile).
verify_owner	send	Submit the SMS code Agentline texted your owner at signup to confirm their mobile.
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.

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 and mobile.

The full agent docs, including a summary to pass on to your human, are at /agents.

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