SmartAlex Documentation - AI Voice Assistant Platform

SmartAlex ships a live Model Context Protocol (MCP) server, so any MCP-capable client can operate your workspace just by talking to it. This page shows how to wire up Gemini CLI as a SmartAlex Gemini MCP client, then drive real voice agents, campaigns, calls, and deals straight from the terminal.

Gemini here is the MCP client you prompt. SmartAlex runs the actual voice agents that place and answer calls. Our voice layer is curated, high-accuracy speech, language, and voice models, kept abstracted. So if you searched for “Gemini voice AI,” the honest picture is simple: you talk to Gemini, and SmartAlex does the calling.

How the connection works

Gemini CLI connects to the hosted SmartAlex MCP server at https://mcp.getsmartalex.com. You sign in to SmartAlex once, and every tool call then runs as you, in the workspace you last opened in SmartAlex, with your role’s permissions. The assistant only ever sees and touches your own data.

Before you start

You need a SmartAlex account and Gemini CLI. There is no API key: you sign in to SmartAlex in your browser. Sign-in opens a browser on the machine running Gemini CLI, so it does not work in a session with no browser, such as a remote SSH session.

Connect Gemini CLI

Gemini CLI reads its MCP servers from ~/.gemini/settings.json. Add a smartalex entry that points at the hosted server.

~/.gemini/settings.json

{
  "mcpServers": {
    "smartalex": {
      "httpUrl": "https://mcp.getsmartalex.com"
    }
  }
}

Start Gemini CLI and sign in:

/mcp auth smartalex

Your browser opens. Sign in to SmartAlex and press Allow. If Gemini CLI later says the sign-in has expired, run the same command again. Then confirm the tools are live:

Prompt: List the SmartAlex tools you can call, then show my voice agents.

If SmartAlex responds with your agents, the connection is good. Every tool is prefixed smartalex_, so it is easy to spot which calls are hitting the platform.

Example prompts

Once connected, you operate the account conversationally. Gemini interprets intent, then calls the right smartalex_ tools in sequence.

Show my voice agents and which phone numbers each one answers.

Add a contact named Jordan Lee at +14155550142, then have my qualifier
agent call them and log the outcome.

Create an outbound campaign called "Spring promo" for the leads list,
use my Reception agent, and schedule it for weekday mornings.

Summarize yesterday's completed calls: who called, sentiment, and any
deals that changed stage.

Give me the widget install code for my website so I can paste it before
the closing body tag.

That last one returns the exact script tag you drop onto any site:

<script src="https://api.getsmartalex.com/storage/v1/object/public/widget-assets/smartalex-widget.js" data-tenant-id="YOUR_TENANT_ID" async></script>

What the server exposes

The MCP server has 80 tools, plus 7 read-only resources and 5 prompts. 31 tools only read, 30 create or change data, and 19 ask you first because they spend money, contact real people or delete something for good. Tools your plan, add-ons or role don’t allow are hidden. The main areas:

Domain	Typical prompt
Agents	”Create a receptionist agent that books callbacks.”
Contacts	”Add these five leads and tag them ‘inbound’.”
Campaigns	”Launch the reactivation campaign tomorrow at 9am.”
Calls	”Show the transcript for the last failed call.”
Deals	”Move the Acme deal to Negotiation.”
Phone numbers	”Which numbers are attached to which agents?”
Webhooks	”Subscribe to call.completed and deal.stage_changed.”
Platform and widgets	”Get my widget install code.”

Full argument reference: tools reference and agent capabilities.

Deletes are irreversible. Before one runs, the server returns a preview of exactly what will be deleted, and Gemini must show it to you and wait for your yes. Read the preview before you approve. See Security and permissions. Requests are rate limited to 100 per minute per workspace, so batch large jobs rather than firing hundreds of single calls.

Webhook subscriptions are creatable through MCP today with the Power Tools add-on, and each returns an HMAC-SHA256 signing secret once at creation. Outbound event delivery is still in private beta, so do not build hard dependencies on real-time event push yet. For live event-driven automation, use Custom HTTP Tools (Power Tools), which let an agent call your own HTTPS endpoint mid-call.

MCP getting started

Every supported client, transport, and config file in one place.

Tools reference

Every tool with arguments and return shapes.

Build with Claude Code

The cloud, OAuth-based connect flow for Claude Code.

What is MCP?

A plain-English primer on the Model Context Protocol.

Start here

AI coding tools

Website builders

Automation

Use SmartAlex with Gemini

How the connection works

Before you start

Connect Gemini CLI

Example prompts

What the server exposes

MCP getting started

Tools reference

Build with Claude Code

What is MCP?

​How the connection works

​Before you start

​Connect Gemini CLI

​Example prompts

​What the server exposes

​Related

MCP getting started

Tools reference

Build with Claude Code

What is MCP?

How the connection works

Before you start

Connect Gemini CLI

Example prompts

What the server exposes

Related