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

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

Updated 2026-10-17 · https://agentline.nz/guides/add-sms-to-cursor-vscode-claude-code

## 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](https://agentline.nz/openapi.json) 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](https://agentline.nz/install).

## 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.