@smartalex/mcp-server

SmartAlex MCP Server — Manage voice agents, campaigns, contacts, and deals from Claude, ChatGPT, Gemini, Cursor, or VS Code.

Quick Start

1. Get your API key

Go to SmartAlex Dashboard → Settings → API Keys and create a new key.

2. Configure your AI client

Add to your client's MCP configuration:

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows)

Cursor — .cursor/mcp.json

VS Code — .vscode/mcp.json

Gemini CLI — ~/.gemini/settings.json

{
  "mcpServers": {
    "smartalex": {
      "command": "npx",
      "args": ["@smartalex/mcp-server"],
      "env": {
        "SMARTALEX_API_KEY": "sa_live_your_key_here"
      }
    }
  }
}

Windows: Use "command": "cmd" with "args": ["/c", "npx", "-y", "@smartalex/mcp-server"].

3. Try it

Open your AI client and say:

"List my contacts" "Create an agent for my website https://example.com" "Show me recent calls"

Tools (26)

| Tool | Domain | Description | |------|--------|-------------| | list_contacts | Contacts | Paginated contact list | | get_contact | Contacts | Single contact by ID | | create_contact | Contacts | Create new contact | | update_contact | Contacts | Update contact fields | | list_agents | Agents | List voice agents | | get_agent | Agents | Single agent by ID | | create_agent | Agents | Quick Setup — create agent from website URL | | create_agent_advanced | Agents | Advanced Setup — fully customized agent | | update_agent | Agents | Update agent settings with voice platform sync | | delete_agent | Agents | Permanently delete agent | | list_phone_numbers | Campaigns | List available phone numbers | | list_campaigns | Campaigns | List all campaigns | | get_campaign | Campaigns | Campaign details with stats | | create_campaign | Campaigns | Create campaign with agent, objective, hours | | add_contacts_to_campaign | Campaigns | Add contacts to campaign | | start_campaign | Campaigns | Start calling | | list_calls | Calls | Paginated call records | | get_call | Calls | Call detail with transcript | | list_deals | Deals | List deals (filter by stage) | | create_deal | Deals | Create pipeline deal | | update_deal | Deals | Update deal stage/value | | delete_deal | Deals | Permanently delete deal | | list_webhooks | Webhooks | Active subscriptions | | create_webhook | Webhooks | Subscribe to events | | delete_webhook | Webhooks | Unregister subscription | | get_platform_status | Platform | Health check + stats |

All tool names are prefixed with smartalex_ (e.g. smartalex_list_contacts).

Configuration

| Variable | Required | Description | |----------|----------|-------------| | SMARTALEX_API_KEY | Yes | Your SmartAlex API key — get it from Dashboard → Settings → API Keys |

Documentation

• MCP Overview
• Getting Started
• Tools Reference
• Usage Examples

License

Proprietary — THERCSGROUP Pte Ltd (Singapore). All rights reserved.