The MCP server and Custom HTTP Tools are the live programmatic surfaces today. A public REST API and TypeScript SDK are in private beta and coming soon.
At a glance
These are the main areas, not the full list. The MCP server overview lists every area.
Bottom line: SmartAlex is one of the few voice platforms an AI agent can run end to end today, through a live MCP server that you connect by signing in, with strict per-workspace isolation, your role’s permissions, and a yes from you before anything that spends money, contacts people or deletes for good. A public REST API is arriving soon.
The operating surface
Every tool is prefixedsmartalex_ so it never clashes with other MCP servers, and each one maps to a real operation in your workspace. Grouped by domain, here are the main capabilities an AI agent gets.
Create and manage voice agents
An agent can stand up a working voice assistant from almost nothing. Give it a website URL andsmartalex_create_agent scrapes the business, analyzes it, generates an optimized prompt, and deploys a live agent in about 30 to 60 seconds. It can also set the assistant name, objective, first message, voice, and accent. From there it can list agents, read full configuration, update behavior and tools, assign a phone number, toggle active status, and delete an agent. Prompt-affecting changes regenerate the system prompt and sync automatically to the live voice platform.
Run outbound campaigns
The full outbound loop is available without a dashboard. An agent can create a campaign, set the objective and calling hours with a timezone, add contacts in batches, and start calling. It can read campaign detail including contact counts and call statistics, and check status as calls progress. Before starting, the tools guide the assistant to confirm the campaign has an agent, an objective, contacts, and a phone number, so it fails with a clear message rather than a bad run.Manage contacts and deals
An agent can keep your CRM current: list and look up contacts, create new ones with company and tags, and apply partial updates. On the pipeline side it can list deals filtered by stage, create deals with a value and linked contact, move them through stages fromlead to closed_won, and delete them. This lets an assistant turn a call outcome into a pipeline update in the same conversation.
Read calls and analytics
An agent can browse call history with direction, status, duration, sentiment score, and cost, then pull the full transcript for any single call. The platform status tool returns workspace usage stats (total contacts, campaigns, calls, and deals) alongside a health check, so an assistant can answer “how did last week look” from real data.Manage phone numbers
An agent can list the active numbers on the account, search available numbers by country across the supported regions, and buy a specific number in E.164 format. Purchased numbers are immediately usable for campaigns and agent assignment.Fetch widget install code
An agent can callsmartalex_get_widget_install_code to return a ready-to-paste HTML script tag plus platform-specific variants for React, WordPress, and Shopify, with a short install guide. This lets an assistant help a user embed the SmartAlex chat and voice widget on their site without leaving the conversation.
Set up webhooks
An agent can create event-driven integrations: subscribe an HTTPS endpoint to events such ascall.completed, deal.stage_changed, contact.created, and campaign.completed, list active subscriptions with their failure counts, and remove a webhook. Each subscription returns an HMAC-SHA256 signing secret once at creation for verifying delivery authenticity.
Beyond the tools, the server ships 7 read-only resources that give an assistant ambient context about your workspace, and 5 prompts that are ready-made workflows for campaign strategy, lead qualification, and call analysis.
Read, change, and ask first
Of the 80 tools, 31 only read, 30 create or change data, and 19 ask you first.
Before an ask-first action runs, the server returns a preview of exactly what will happen, with the cost where there is one. The AI app must show it to you and wait for your yes. Only then can it run the action, with a one-time code from that preview that works once and expires after 10 minutes. This is on for every workspace and cannot be turned off.
Every tool also carries MCP annotations so a well-behaved client knows how to treat it:
readOnlyHint marks the safe list and get tools, destructiveHint marks permanent deletes, and idempotentHint marks updates that are safe to retry. Security and permissions lists the ask-first actions.
The operating contract
An AI agent operates SmartAlex under a clear contract: how it authenticates, what it can reach, and how fast it can go.Signing in
You connect by addinghttps://mcp.getsmartalex.com to your AI app, signing in to SmartAlex in your browser, and pressing Allow. There is no API key to copy and no password in a file. API keys (sa_live_ and sa_test_) are not self-serve.
The AI app then acts as you, with your role’s permissions. Tools your plan, add-ons or role don’t allow are hidden: campaign tools and buying numbers need the Outbound Campaigns add-on, HTTP tools and creating or deleting webhooks need Power Tools, and creating an agent needs a free agent slot.
Tenant isolation
This is the guarantee that makes it safe to let an assistant act. A signed-in AI app works in exactly one workspace: the one you last opened in SmartAlex. The gateway then scopes every read and write to that workspace, so a sign-in reaches only that one workspace. An AI agent connected to your workspace only ever sees and touches your workspace.Rate limits
Going over returns a
429 with a Retry-After header and X-RateLimit-* headers, and most clients back off automatically. The public REST path, when it ships, will carry its own per-key limit (default 60 per minute, adjustable at key creation).
What stays hidden
Provider details are never exposed. Agent records returnvoice_provider as "cloud" rather than any underlying vendor, because SmartAlex runs a curated, high-accuracy speech-to-text, language, and text-to-speech stack behind the platform, and keeps it abstracted. Signing secrets are returned only once, and all traffic is HTTPS.
Live today, and what is next
Live now
The MCP server (cloud and local) and Custom HTTP Tools, which let an agent call your own HTTPS endpoint mid-call, are live in production today.
Coming soon
A public REST API, a TypeScript SDK, and outbound webhook events are in private beta. Contact support for early access.
Connect an agent in two minutes
Connect to the hosted server and sign in, with no install and no key to copy. In Claude Code:Frequently asked questions
Can an AI agent create and run a voice agent on SmartAlex?
Yes. Through the MCP server, an assistant callssmartalex_create_agent with a website URL or a company name, and SmartAlex analyzes the business, generates a prompt, and deploys a live voice agent in about 30 to 60 seconds. The assistant can then assign a phone number, add the agent to a campaign, add contacts, and start outbound calling, all in one conversation.
How does SmartAlex keep an AI agent inside its own workspace?
A signed-in AI app acts as you, in the workspace you last opened in SmartAlex, with your role’s permissions. The API gateway scopes every read and write to that workspace, so a connected AI agent can never see or change another tenant’s contacts, agents, campaigns, or calls. Isolation is enforced at the gateway, not left to the client.Which SmartAlex actions are read-only versus write?
Of the 80 tools, 31 only read (lists, look-ups, transcripts, usage, number search, and widget code), 30 create or change data, and 19 ask you first because they spend money (3), contact real people (7), or delete something for good (9). For those 19, the AI app must show you a preview and get your yes before it can run them.Does SmartAlex have a public REST API for AI agents?
A public REST API is in private beta and coming soon, alongside a TypeScript SDK and outbound webhook events. Today the live programmatic surfaces are the MCP server, which covers the full operational surface an agent needs, and Custom HTTP Tools, which let an agent call your own HTTPS endpoint during a call. Contact support if you need REST API early access.What can an AI agent not do through SmartAlex?
An agent cannot cross workspace boundaries, cannot see the underlying voice providers (agent records report a genericcloud provider), and cannot do more than your role allows. Requests are rate limited to 100 per minute per workspace, and the 19 actions that spend money, contact people, or delete for good need your yes first. These limits are what make it safe to hand an assistant real access.
Related
MCP server overview
The 80 tools, 7 resources, and 5 prompts, and how the pieces fit together.
Getting started
Connect Claude, ChatGPT, Cursor, or Gemini to SmartAlex in under two minutes.
Tools reference
Every tool with its parameters, examples, and response shapes.
What is MCP?
A plain-language explainer of the Model Context Protocol.