Metadata-Version: 2.4
Name: anam-mcp
Version: 0.1.7
Summary: Official Anam AI MCP server for managing AI personas
Project-URL: Homepage, https://github.com/anam-org/anam-mcp
Project-URL: Documentation, https://docs.anam.ai
Project-URL: Repository, https://github.com/anam-org/anam-mcp
Project-URL: Issues, https://github.com/anam-org/anam-mcp/issues
Author-email: Anam AI <support@anam.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,anam,avatar,digital-human,mcp,persona
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Anam MCP Server

Official MCP (Model Context Protocol) server for [Anam AI](https://anam.ai) - manage AI personas, avatars, voices, and sessions directly from Claude or any MCP client.

## Installation

### Using uvx (recommended)

```bash
uvx anam-mcp
```

### Using pip

```bash
pip install anam-mcp
```

## Configuration

### Claude Desktop

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

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

### Claude Code

Add to your project's `.mcp.json`:

```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](https://lab.anam.ai)
2. Navigate to the [API Keys page](https://lab.anam.ai/api-keys)
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 |

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

## Documentation

- [Anam Developer Docs](https://docs.anam.ai)
- [API Reference](https://docs.anam.ai/api-reference)
- [Avatar Gallery](https://docs.anam.ai/resources/avatar-gallery)
- [Voice Gallery](https://docs.anam.ai/resources/voice-gallery)

## License

MIT License - see [LICENSE](LICENSE) for details.
