Menu
How it worksPricingFor agentsInstallDocsGuidesSign inStart free

Add SMS and email tools to Cursor, VS Code and Claude Code

Updated · Markdown

Short answer

Agentline is a remote MCP server at https://agentline.nz/mcp using Streamable HTTP and OAuth 2.1. In Cursor and VS Code, click the install button on agentline.nz/install. In Claude Code, run claude mcp add --transport http agentline https://agentline.nz/mcp; in Codex CLI, codex mcp add agentline --url https://agentline.nz/mcp; in Gemini CLI, gemini mcp add --transport http agentline https://agentline.nz/mcp. Sign in when prompted, or use an API key header.

Install buttons

  • Cursor: the cursor:// install link adds {"url": "https://agentline.nz/mcp"} to your MCP config.
  • VS Code (Copilot): the vscode:mcp/install link, a vscode.dev fallback link, or code --add-mcp '{"name":"agentline","type":"http","url":"https://agentline.nz/mcp"}'.
  • Goose: a goose://extension link for Goose Desktop.

Command-line clients

claude mcp add --transport http agentline https://agentline.nz/mcp
codex mcp add agentline --url https://agentline.nz/mcp && codex mcp login agentline
gemini mcp add --transport http agentline https://agentline.nz/mcp

API keys for CI and headless agents

OAuth is best for people. For scripts and CI, create an API key in the dashboard and send Authorization: Bearer al_live_…. Each key is one connected agent (1 on Free, up to 10 on Starter and Pro); revoke it from the dashboard, the CLI or revoke_api_key.

Using it from code

The same features are on the REST API, so you can test without an MCP client:

curl -X POST https://agentline.nz/api/v1/wait-for-code \
  -H "Authorization: Bearer $AGENTLINE_KEY" -H "Content-Type: application/json" \
  -d '{"channel":"sms","from_contains":"Acme","timeout_seconds":45}'

wait_for_code waits up to 55 seconds (45 by default) and looks back 10 minutes by default. If it returns found: false, call it again. The OpenAPI spec covers every endpoint, and cli/agentline.mjs wraps them.

Troubleshooting

  • 401 on every call: the client hasn't finished OAuth. Run its sign-in step: /mcp in Claude Code, codex mcp login agentline, or /mcp auth agentline in Gemini CLI.
  • 403 recipient_not_allowed: Free and trial accounts can message only the owner's verified email and mobile.
  • 409 number_pending: the 028 number is still being set up. Email works meanwhile.
  • 429 rate_limited: wait for the number of seconds in Retry-After.

Testing without an account

The keyless server at https://agentline.nz/public/mcp needs no credentials. It offers pricing, availability, docs and install instructions, and signup. Nothing on it can send a message for you.

All clients, including Windsurf, Cline, Zed and n8n, are on the install page.

Common questions

Which MCP transport does Agentline use?
Streamable HTTP at https://agentline.nz/mcp, with OAuth 2.1 (Client ID Metadata Documents and Dynamic Client Registration) or an API key in the Authorization header.
Can I use Agentline in CI without a browser sign-in?
Yes. Create an API key in the dashboard and send it as Authorization: Bearer al_live_… on /mcp or /api/v1.
Is there a way to try it before signing up?
Yes. The keyless MCP server at https://agentline.nz/public/mcp needs no credentials. It can describe pricing, availability and installs, and create an account, but it can't send anything.

Give your agent a number

Inbox live from day one; NZ 028 number set up within a few days of signup.

Get started

Related guides