OpenAI Agents SDK: NZ number, SMS and email

Short answer

Use MCPServerStreamableHttp from agents.mcp with url https://agentline.nz/mcp and an Authorization: Bearer header holding your Agentline NZ API key, then pass the server to your Agent in mcp_servers. Your agent gets Agentline NZ's tools for texting from a New Zealand 028 number, email and wait_for_code.

Before you start

An Agentline NZ API key from Dashboard → API keys, exported as AGENTLINE_KEY. Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number.
Your 028 number is set up within a few days of signup. Your email inbox works straight away.

Steps

Install the SDK. Install the openai-agents package.
```
pip install openai-agents
```

Connect to Agentline NZ. Open an MCPServerStreamableHttp connection with your key in the headers and give it to the agent.

import asyncio, os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        name="agentline",
        params={
            "url": "https://agentline.nz/mcp",
            "headers": {"Authorization": f"Bearer {os.environ['AGENTLINE_KEY']}"},
            "timeout": 60,
        },
        cache_tools_list=True,
    ) as agentline:
        agent = Agent(
            name="Assistant",
            instructions="Use Agentline NZ to text, email and wait for one-time codes.",
            mcp_servers=[agentline],
        )
        result = await Runner.run(agent, "What's my Agentline NZ number?")
        print(result.final_output)

asyncio.run(main())

Run it. Run the script. The agent should call get_my_number and print your number and inbox.

JavaScript

import { Agent, run, MCPServerStreamableHttp } from '@openai/agents';

const agentline = new MCPServerStreamableHttp({
  name: 'agentline',
  url: 'https://agentline.nz/mcp',
  requestInit: { headers: { Authorization: `Bearer ${process.env.AGENTLINE_KEY}` } },
});
await agentline.connect();
const agent = new Agent({ name: 'Assistant', mcpServers: [agentline] });
console.log((await run(agent, "What's my Agentline NZ number?")).finalOutput);
await agentline.close();

Good to know

Set the timeout above 55 seconds if your agent uses wait_for_code with a long timeout, because the tool call waits for the code to arrive.
The SDK also has HostedMCPTool, where OpenAI's Responses API connects to the server for you. We've used the local client because its header handling is documented for any server.
Standard NZ mobile numbers only (020–029). No landlines, short codes, premium or international numbers.

FAQ

What does Agentline NZ cost?

Starter is NZ$29/month and Pro is NZ$79/month, billed in NZ dollars. Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number. Agentline NZ is not GST-registered, so no GST is charged.

How long does it take to get the 028 number?

Your 028 number is set up within a few days of signup. Your email inbox works straight away. Full refund if your number hasn't arrived within 30 days of paying.

Can my assistant send marketing or bulk texts?

No. Transactional and assistant messages only: replies, bookings, confirmations, reminders people asked for, and codes. Marketing, promotions, cold texts and bulk texts are blocked. See What we don't allow.

Start free · Start free with an email inbox (no card), or take a 7-day trial of Starter or Pro to get a number.

Connect the OpenAI Agents SDK to a NZ phone number, SMS and email