> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getsmartalex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SmartAlex for AI-native builders

> The fastest way to add real phone and voice capability to any app you build with Claude Code, Cursor, Lovable, v0, Bolt, or Replit. Operate SmartAlex from your agent, or embed a voice widget.

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 28-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.

<Note>
  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.
</Note>

## Two ways to build

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

```mermaid theme={null}
flowchart TD
    A[You build with Claude Code, Cursor, Lovable, v0, Bolt, or Replit] --> B{What do you need?}
    B -->|Build and run voice agents in conversation| C[Operate SmartAlex via MCP]
    B -->|Add voice or chat to the app you generate| D[Embed a widget]
    C --> E[28 tools: agents, contacts, campaigns, calls, deals, numbers, webhooks]
    D --> F[One script tag or a React component]
```

## 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.

The hosted endpoint uses OAuth, so there is no key to manage. Claude Code prompts you to approve in the browser on first use.

<CodeGroup>
  ```bash Cloud (hosted, OAuth) theme={null}
  claude mcp add --transport http smartalex https://api.getsmartalex.com/functions/v1/mcp-server
  ```

  ```bash Local (npm package, API key) theme={null}
  export SMARTALEX_API_KEY=sa_live_your_key_here
  claude mcp add smartalex -- npx @smartalex/mcp-server
  ```
</CodeGroup>

The MCP server exposes 28 tools, 7 resources, and 5 prompts across 8 domains (voice agents, contacts, campaigns, calls, deals, phone numbers, webhooks, and platform plus widgets). 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.

<Info>
  The local (API key) path needs a key from the Developer Portal, which requires the Power Tools add-on (\$29/month) and a super-admin role on the workspace. The hosted OAuth path has no such requirement. See [MCP authentication](/mcp/authentication).
</Info>

**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](/mcp/getting-started).

## Embed a voice widget

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:

```html theme={null}
<!-- 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:

```tsx theme={null}
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}</>;
}
```

<Tip>
  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.
</Tip>

**Best for:** adding a voice or chat surface to a site or app you generated. See [widget types](/essentials/widgets) and the [install guide](/essentials/widget-install).

## 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                                 |

<Note>
  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.
</Note>

## Pick your tool

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="/build-with/claude-code">
    Build and run voice agents in conversation. First-class MCP support, hosted or local.
  </Card>

  <Card title="Cursor, v0, and Bolt" icon="code" href="/build-with/cursor-v0-bolt">
    Connect the MCP server in your editor, or embed the widget in generated apps.
  </Card>

  <Card title="Lovable" icon="wand-magic-sparkles" href="/build-with/lovable">
    Add a voice widget to a Lovable app with a single React injection.
  </Card>

  <Card title="Any MCP client" icon="plug" href="/mcp/getting-started">
    ChatGPT, VS Code, Windsurf, Gemini CLI, and more. Connect by URL or npm.
  </Card>
</CardGroup>

## Related

<CardGroup cols={2}>
  <Card title="MCP server overview" icon="server" href="/mcp/overview">
    The 28 tools, resources, and prompts your agent can call.
  </Card>

  <Card title="Widget types" icon="comments" href="/essentials/widgets">
    Voice, chat, and full messenger variants for your app.
  </Card>

  <Card title="Best voice AI for AI agents" icon="robot" href="/comparisons/best-voice-ai-for-ai-agents">
    How SmartAlex compares for agent-native builders.
  </Card>

  <Card title="Pricing" icon="tag" href="/pricing">
    Plans, add-ons, and usage rates.
  </Card>
</CardGroup>