SmartAlex Documentation - AI Voice Assistant Platform

If you build with Claude Code, Cursor, Lovable, v0, Bolt, or Replit, SmartAlex is the fastest way to add voice AI to your app. You get real phone numbers, live voice agents, a CRM, campaigns, and analytics behind one interface, and two ways to reach them: operate the platform from your agent, or embed a voice widget into whatever you generate. SmartAlex is agent-native by design. The platform is built to be operated by AI agents, so an AI voice API for builders is not bolted on later: the same 80-tool control surface you drive from Claude Code is what runs in production. It works exceptionally well with Claude Code (SmartAlex is listed in the Claude MCP directory) and with any other MCP client.

Under the hood, agents run on curated, high-accuracy speech, language, and voice models, kept abstracted. There is nothing to tune and no vendor to wire up. You describe the agent, SmartAlex runs it.

Two ways to build

There are two paths, and most teams use both. Pick by what you are trying to ship.

Operate SmartAlex from your agent

Connect the live MCP server and your agent can create, configure, and run voice agents in plain conversation. It scaffolds an agent from a website URL, assigns a number, launches an outbound campaign, reads transcripts and call stats, and moves deals through the pipeline, all without leaving your editor or terminal. You connect by signing in, so there is no key to manage. Claude Code asks you to sign in to SmartAlex in the browser on first use.

claude mcp add --transport http smartalex https://mcp.getsmartalex.com

The MCP server exposes 80 tools, 7 resources, and 5 prompts, covering voice agents, contacts, campaigns, calls, deals, phone numbers, webhooks, widgets and more. One tool, smartalex_create_agent, builds a live agent from a website URL: it reads the business, writes an optimized prompt, and deploys in roughly 30 to 60 seconds.

Your agent acts as you, with your role’s permissions, and only gets the tools your plan and add-ons include. Actions that spend money, contact real people or delete something for good ask you first. API keys are not self-serve, and you don’t need one. See Security and permissions.

Best for: builders and AI agents who want to create and run voice agents, campaigns, and CRM from chat or the command line. Start at MCP getting started. Want voice AI for AI-generated apps? Drop a widget into any site or app you build and you have a talk-to-us surface backed by a live agent. It is one external script from the SmartAlex host, so there is no package to install and nothing to bundle. For static or HTML output, paste this just before the closing </body> tag and swap in your real tenant id:

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

For a React or Next.js app (what v0, Lovable, and Bolt usually generate), inject the script from your root layout:

import { useEffect } from 'react';

export default function Layout({ children }) {
  useEffect(() => {
    const script = document.createElement('script');
    script.src = 'https://api.getsmartalex.com/storage/v1/object/public/widget-assets/smartalex-widget.js';
    script.setAttribute('data-tenant-id', 'YOUR_TENANT_ID');
    script.async = true;
    document.body.appendChild(script);
    return () => { document.body.removeChild(script); };
  }, []);
  return <>{children}</>;
}

Your data-tenant-id is shown in the widget code panel in-app, or your agent can fetch the ready-to-paste snippet with the smartalex_get_widget_install_code tool (it returns HTML plus React, WordPress, and Shopify variants). The widget reads its published config at load time, so you restyle it in Widget Studio without touching the site again.

Best for: adding a voice or chat surface to a site or app you generated. See widget types and the install guide.

Which path is right for you

	Operate via MCP	Embed a widget
What it is	Your agent drives the platform	A voice or chat surface on your app
You ship	Live agents, campaigns, CRM actions	A website talk-to-us experience
How you connect	MCP server (hosted or local)	Script tag or React component
Who runs it	Claude Code, Cursor, ChatGPT, any MCP client	Any site or app you generate
Live today	Yes	Yes

The live programmatic surfaces today are the MCP server and Custom HTTP Tools, plus the website widget embed. A public REST API and TypeScript SDK are in private beta and coming soon. If a shipped REST API is a hard requirement right now, factor that into your timing.

Pick your tool

Claude Code

Build and run voice agents in conversation. First-class MCP support, connect by signing in.

Cursor, v0, and Bolt

Connect the MCP server in your editor, or embed the widget in generated apps.

Lovable

Add a voice widget to a Lovable app with a single React injection.

Any MCP client

ChatGPT, Codex, Gemini CLI, and more. Connect by URL and sign in.

MCP server overview

The 80 tools, resources, and prompts your agent can call.

Widget types

Voice, chat, and full messenger variants for your app.

Best voice AI for AI agents

How SmartAlex compares for agent-native builders.

Pricing

Plans, add-ons, and usage rates.

Start here

AI coding tools

Website builders

Automation

SmartAlex for AI-native builders

Two ways to build

Operate SmartAlex from your agent

Embed a voice widget

Which path is right for you

Pick your tool

Claude Code

Cursor, v0, and Bolt

Lovable

Any MCP client

MCP server overview

Widget types

Best voice AI for AI agents

Pricing

​Two ways to build

​Operate SmartAlex from your agent

​Embed a voice widget

​Which path is right for you

​Pick your tool

Claude Code

Cursor, v0, and Bolt

Lovable

Any MCP client

​Related

MCP server overview

Widget types

Best voice AI for AI agents

Pricing

Two ways to build

Operate SmartAlex from your agent

Embed a voice widget

Which path is right for you

Pick your tool

Related