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

# Anam MCP

> Manage personas, avatars, voices, sessions, and more from Claude or any MCP client.

The [Anam MCP server](https://github.com/anam-org/anam-mcp) lets you manage your Anam account directly from Claude Desktop, Cursor, Claude Code, or any MCP-compatible client. It provides 55+ tools covering personas, avatars, voices, knowledge bases, sessions, and more.

<Card title="Source Code" icon="github" href="https://github.com/anam-org/anam-mcp">
  Full source and documentation on GitHub
</Card>

## Setup

### Prerequisites

* An [Anam account](https://lab.anam.ai) with an API key
* Python 3.10+ (for `uvx`/`pip` install)

### Claude Desktop

Go to **Settings → Connectors → Add custom connector** and enter:

```
https://docs.anam.ai/mcp
```

Alternatively, add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json theme={"system"}
{
  "mcpServers": {
    "anam": {
      "command": "uvx",
      "args": ["anam-mcp"],
      "env": {
        "ANAM_API_KEY": "<your-api-key>"
      }
    }
  }
}
```

### Claude Code

```bash theme={"system"}
claude mcp add --transport http anam https://docs.anam.ai/mcp
```

Or add to your project's `.mcp.json`:

```json theme={"system"}
{
  "mcpServers": {
    "anam": {
      "type": "stdio",
      "command": "uvx",
      "args": ["anam-mcp"],
      "env": {
        "ANAM_API_KEY": "<your-api-key>"
      }
    }
  }
}
```

### Cursor

Press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux), type "Open MCP settings", then add:

```json theme={"system"}
{
  "mcpServers": {
    "anam": {
      "url": "https://docs.anam.ai/mcp"
    }
  }
}
```

## What You Can Do

### Persona Management

Create, update, list, and delete personas — combinations of avatar + voice + LLM + system prompt that define an AI agent.

### Avatar & Voice Management

Browse and search avatars and voices across 70+ languages. Create custom avatars within your plan allowance and create custom voices across plans.

### Knowledge Base

Create knowledge folders, upload documents, and search across your knowledge base. Connect knowledge tools to personas for RAG-powered conversations.

### Tools

Create webhook tools for API integrations and knowledge tools for document retrieval. Attach tools to personas.

### LLM Configuration

List built-in LLMs, create custom LLM configurations (OpenAI, Azure, Gemini, Groq), and assign them to personas.

### Session Management

Generate session tokens, list sessions, get session details, and download session recordings.

### Share Links

Create shareable links to persona experiences for demos and testing.

### Text-to-Avatar

Generate MP4 videos of avatars speaking a script.

### Meeting Avatars (Recall Integration)

Add AI avatars to live video meetings on **Zoom**, **Google Meet**, and **Microsoft Teams** using the [Recall AI](https://recall.ai) integration. The avatar joins the meeting as a participant with a camera feed, and meeting audio is piped to the avatar for real-time conversation.

| Tool                         | Description                           |
| ---------------------------- | ------------------------------------- |
| `add_avatar_to_meeting`      | Add an Anam avatar to a video meeting |
| `get_meeting_bot_status`     | Check the status of a meeting bot     |
| `remove_avatar_from_meeting` | Remove an avatar from a meeting       |
| `list_meeting_bots`          | List all active meeting bots          |

To enable meeting avatars, set the `RECALL_API_KEY` environment variable alongside your `ANAM_API_KEY`.

## Example Prompts

Once configured, try asking your AI assistant:

* "List all my Anam personas"
* "Create a new persona named 'Sales Assistant' with a friendly personality"
* "What voices are available in British English?"
* "Upload our FAQ PDF to the knowledge base and connect it to my support persona"
* "Generate a session token for my customer support persona"
* "Add an avatar to my Google Meet call"
* "Create a shareable demo link for my sales persona"

## Environment Variables

| Variable         | Description                             | Required |
| ---------------- | --------------------------------------- | -------- |
| `ANAM_API_KEY`   | Your Anam API key                       | Yes      |
| `RECALL_API_KEY` | Recall AI API key (for meeting avatars) | No       |