anam-mcp 0.1.8

Official Anam AI MCP server for managing AI personas

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

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

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 [e-mail] for access.

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

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"

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
TEXT_TO_AVATAR_URL	Text-to-avatar service URL (early access)	https://anam-org--text-to-avatar-api.modal.run

Documentation

• Anam Developer Docs
• API Reference
• Avatar Gallery
• Voice Gallery

License

MIT License - see LICENSE for details.