MMCPMarkets
AO

anam-org/anam-mcp

Developer tools
30 stars 0 forks Quality 90 Trend 90
Repository Install

Official Anam AI MCP server for managing AI avatars

Overview

Official MCP (Model Context Protocol) server for Anam AI - manage AI personas, avatars, voices, and sessions directly from Claude or any MCP client. Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS): 1. Sign up at Anam Lab 2. Navigate to the API Keys page 3. Click "Create API key" and save it securely - This feature is in early access. Contact [email protected] for access. Add AI avatars to video meetings (Zoom, Google Meet, Microsoft Teams). Requires a Recall AI API key. : Set RECALL_API_KEY environment variable alongside your ANAM_API_KEY. - "List all my Anam personas" - "Create a new persona named 'Sales Assistant' with a friendly personality" - "What avatars are available?" - "Generate a session token for my customer support persona" - "Add an avatar to my Google Meet call at meet.google.com/abc-defg-hij" For quick testing, you can use these default IDs:

README

Anam MCP Server

Official MCP (Model Context Protocol) server for Anam AI - manage AI personas, avatars, voices, and sessions directly from Claude or any MCP client.

Installation

uvx anam-mcp

Using pip

pip install anam-mcp

Configuration

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "anam": {
      "command": "uvx",
      "args": ["anam-mcp"],
      "env": {
        "ANAM_API_KEY": ""
      }
    }
  }
}

Claude Code

Add to your project’s .mcp.json:

{
  "mcpServers": {
    "anam": {
      "type": "stdio",
      "command": "uvx",
      "args": ["anam-mcp"],
      "env": {
        "ANAM_API_KEY": ""
      }
    }
  }
}

Getting Your API Key

  1. Sign up at Anam Lab
  2. Navigate to the API Keys page
  3. Click “Create API key” and save it securely

Available Tools

Persona Management

Tool Description
list_personas List all personas in your account
get_persona Get details of a specific persona
create_persona Create a new persona with avatar, voice, and personality
update_persona Update an existing persona
delete_persona Delete a persona

Avatar Management

Tool Description
list_avatars List all available avatars
search_avatars Search avatars by name or description
get_avatar Get details of a specific avatar
create_avatar Create custom avatar from image (enterprise/pro)
update_avatar Update an avatar’s metadata
delete_avatar Delete a custom avatar

Voice Management

Tool Description
list_voices List all available voices (400+ in 50+ languages)
search_voices Search voices by name, language, or gender
get_voice Get details of a specific voice
create_voice Create a custom voice
update_voice Update a voice’s metadata
delete_voice Delete a custom voice

Tool Management

Tool Description
list_tools List all tools in your organization
get_tool Get details of a specific tool
create_webhook_tool Create a webhook tool for API integrations
create_knowledge_tool Create a knowledge/RAG tool
update_tool Update a tool’s configuration
delete_tool Delete a tool

Session Management

Tool Description
create_session_token Generate a session token for the client SDK
list_sessions List all sessions with optional filters
get_session Get details of a specific session
get_session_recording Download a session recording

Knowledge Folders

Tool Description
list_knowledge_folders List knowledge folders
get_knowledge_folder Get details of a specific folder
create_knowledge_folder Create a new folder for documents
update_knowledge_folder Update a folder’s metadata
delete_knowledge_folder Delete a knowledge folder
search_knowledge_folder Search within a knowledge folder

Knowledge Documents

Tool Description
list_knowledge_documents List documents in a folder
get_knowledge_document Get details of a specific document
upload_knowledge_document Upload a document to a folder
update_knowledge_document Update document metadata
delete_knowledge_document Delete a document
get_knowledge_document_download Download a document

LLM Management

Tool Description
list_llms List all LLM configurations
get_llm Get details of a specific LLM
create_llm Create a new LLM configuration
update_llm Update an LLM configuration
delete_llm Delete an LLM configuration
Tool Description
list_share_links List all share links
get_share_link Get details of a specific share link
create_share_link Create a share link for a persona
update_share_link Update a share link
delete_share_link Delete a share link

Text-to-Avatar (Early Access)

Internal Testing - This feature is in early access. Contact [email protected] for access.

Tool Description
generate_avatar_video Generate an MP4 video of an avatar speaking a script

Meeting Avatars (Recall Integration)

Add AI avatars to video meetings (Zoom, Google Meet, Microsoft Teams). Requires a Recall AI API key.

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

Configuration: Set RECALL_API_KEY environment variable alongside your ANAM_API_KEY.

Example Usage

Once configured, you can ask Claude:

  • “List all my Anam personas”
  • “Create a new persona named ‘Sales Assistant’ with a friendly personality”
  • “What avatars are available?”
  • “Generate a session token for my customer support persona”
  • “Add an avatar to my Google Meet call at meet.google.com/abc-defg-hij”

Default IDs

For quick testing, you can use these default IDs:

Resource ID
Avatar (Cara) 30fa96d0-26c4-4e55-94a0-517025942e18
Voice (Cara) 6bfbe25a-979d-40f3-a92b-5394170af54b
Default LLM 0934d97d-0c3a-4f33-91b0-5e136a0ef466

Environment Variables

Variable Description Default
ANAM_API_KEY Your Anam API key (required) -
ANAM_API_URL API base URL (for staging) https://api.anam.ai
RECALL_API_KEY Recall AI API key (for meeting avatars) -
MEET_PAGE_URL Avatar meet page URL https://meet.anam.ai
TEXT_TO_AVATAR_URL Text-to-avatar service URL (early access) https://anam-org--text-to-avatar-api.modal.run

Documentation

License

MIT License - see LICENSE for details.

View this README on GitHub

Install

uvx anam-mcp

Configuration

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