MCP 服务器

Anam MCP Server

Enables managing AI personas, avatars, voices, and sessions from any MCP client, for integration with Anam AI.

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

Using uvx (recommended)

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": "<your-api-key>"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json:

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

Getting Your API Key

Sign up at Anam Lab
Navigate to the API Keys page
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

Share Links

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 support@anam.ai 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`