Metadata-Version: 2.4
Name: forge8-mcp
Version: 1.0.0
Summary: forge8 Developer MCP Server — Make AI voice calls from Claude, Cursor, and any MCP host
Project-URL: Homepage, https://forge8.in
Project-URL: Repository, https://github.com/KirtiBajaj555/forge8new
Project-URL: Documentation, https://forge8.in/docs/mcp
Author-email: forge8 <dev@forge8.in>
License: MIT
Keywords: ai,claude,cursor,forge8,mcp,voice
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Telephony
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: sse-starlette>=2.0.0
Requires-Dist: starlette>=0.35.0
Requires-Dist: uvicorn>=0.25.0
Description-Content-Type: text/markdown

# forge8 MCP Server

Use AI voice calls from any MCP host — Claude, Cursor, Windsurf, and more.

## Quick Start

```bash
uvx forge8-mcp
```

Set your API key:

```bash
FORGE8_API_KEY=f8_key_your_key_here uvx forge8-mcp
```

For Claude Desktop, add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "forge8": {
      "command": "uvx",
      "args": ["forge8-mcp"],
      "env": {
        "FORGE8_API_KEY": "f8_key_your_key_here"
      }
    }
  }
}
```

## SSH/Self-hosted Mode

```bash
FORGE8_API_KEY=f8_key_your_key_here uvx forge8-mcp --mode sse --port 8001
```

Then connect your MCP host to `http://your-host:8001/sse?api_key=f8_key_...`

## Tools

| Tool | Description |
|------|-------------|
| `make_voice_call` | Call a phone number with custom AI instructions |
| `get_usage` | Check trial minutes consumed and remaining |
| `get_call_summary` | Get aggregated call statistics |
| `upload_contacts` | Upload a CSV of contacts for batch calling |
| `manage_api_key` | View or regenerate your API key |

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `FORGE8_API_KEY` | Yes | `""` | Your forge8 developer API key |
| `FORGE8_API_URL` | No | `https://forge8new-production.up.railway.app` | Backend API URL |
| `FORGE8_PUBLIC_API_URL` | No | same as `FORGE8_API_URL` | Public-facing API URL for SSE mode |

## Example (Claude Code)

```
User: Call +919876543210 and tell them we have a special offer
Agent: [runs make_voice_call]
```

## License

MIT
