Metadata-Version: 2.4
Name: agentline-mcp
Version: 0.1.0
Summary: MCP server for Agentline — give your AI agent a phone number, email, SMS, and voice calls.
Project-URL: Homepage, https://www.agentline.co
Project-URL: Documentation, https://www.agentline.co/docs
Author-email: Agentline <support@agentline.co>
License: MIT License
        
        Copyright (c) 2026 Agentline
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: 2fa,agentline,agents,ai,anthropic,claude,email,mcp,model-context-protocol,sms,telephony,voice
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Telephony
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: agentline>=0.1.0
Requires-Dist: mcp>=1.2
Description-Content-Type: text/markdown

# Agentline MCP

**Give your AI agent a phone number, email, SMS, and voice calls — as [MCP](https://modelcontextprotocol.io) tools.**

Install once in Claude Desktop, Cursor, Zed, Windsurf, or any MCP client, and your agent can provision phone numbers, capture 2FA codes, send SMS, place AI voice calls, and send/receive email directly.

## Install

```bash
# requires uv — https://docs.astral.sh/uv/
uvx agentline-mcp
```

Or with pip:

```bash
pip install agentline-mcp
agentline-mcp
```

## Configure

Set your API key as an environment variable. Get one at [agentline.co](https://www.agentline.co).

```bash
export AGENTLINE_API_KEY=ag_live_...
```

### Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "agentline": {
      "command": "uvx",
      "args": ["agentline-mcp"],
      "env": {
        "AGENTLINE_API_KEY": "ag_live_..."
      }
    }
  }
}
```

### Cursor

`~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "agentline": {
      "command": "uvx",
      "args": ["agentline-mcp"],
      "env": {
        "AGENTLINE_API_KEY": "ag_live_..."
      }
    }
  }
}
```

### Zed

Add to `~/.config/zed/settings.json`:

```json
{
  "context_servers": {
    "agentline": {
      "command": {
        "path": "uvx",
        "args": ["agentline-mcp"],
        "env": { "AGENTLINE_API_KEY": "ag_live_..." }
      }
    }
  }
}
```

### Windsurf / Continue / any stdio MCP client

Use the same `uvx agentline-mcp` command and set `AGENTLINE_API_KEY` in the server's env. All major MCP clients share the same stdio launch pattern.

## Tools exposed

### Phone numbers
- `provision_number` — get a phone number the agent can use
- `release_number` — release when done (avoids monthly charges)
- `list_numbers` — list provisioned numbers

### SMS
- `send_sms` — send an outbound SMS
- `wait_for_sms` — long-poll for the next inbound SMS (with optional regex match)
- `capture_code` — **the killer flow.** Provision + wait for 2FA code + release, in one call

### Voice
- `make_call` — place an outbound AI voice call (non-blocking, returns call_id)
- `get_call` — status, transcript, summary for a call
- `hangup_call` — end an in-progress call

### Email
- `create_email_address` — provision an email
- `list_email_addresses` — list provisioned addresses
- `release_email_address` — release
- `send_email` — send an outbound email
- `wait_for_email` — long-poll for an inbound email
- `capture_email_code` — provision + wait for email-based verification code + release

## Example prompts

> "Sign me up for Substack using a throwaway phone number. Capture the 2FA code, paste it into the signup form, then release the number."

> "Call +15551234567, pose as my assistant scheduling a dentist appointment for next Tuesday morning. Summarize the outcome when the call ends."

> "Provision a new email address, start a free trial on example.com with it, and tell me the verification code that arrives."

## Environment variables

| Var | Required | Default | Notes |
|---|---|---|---|
| `AGENTLINE_API_KEY` | yes | — | Starts with `ag_live_` or `ag_test_` |
| `AGENTLINE_BASE_URL` | no | `https://api.agentline.dev` | Override for self-hosted / staging |

## License

MIT
