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

# MCP Universal Chatbot

> Connect Claude Desktop to any Animam chatbot

The MCP Universal Chatbot allows Claude Desktop (and any MCP client) to connect to **any** Animam chatbot and query it directly. Your AI assistant becomes aware of the business context.

<Note>
  This is different from the [MCP Builder](/mcp/introduction) which is for *managing* your own chatbot. MCP Universal is for *querying* any chatbot as a user.
</Note>

## How It Works

```
┌─────────────────────────────────────────────────────────────┐
│                    MCP UNIVERSAL                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   Claude Desktop ──connect──▶ Animam MCP ──query──▶ Chatbot │
│                                                             │
│   "What are Acme's prices?"  →  Queries acme-corp chatbot   │
│                              →  Returns accurate answer      │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

## Quick Start

### 1. Install the MCP Server

Add to your `claude_desktop_config.json`:

```json theme={null}
{
  "mcpServers": {
    "animam-universal": {
      "command": "npx",
      "args": ["@animam/mcp", "--mode", "universal"]
    }
  }
}
```

### 2. Connect to a Chatbot

In Claude Desktop, simply say:

```
Connect to the acme-corp chatbot
```

Claude will discover the chatbot's capabilities and context.

### 3. Ask Questions

```
What are Acme's enterprise pricing plans?
```

Claude queries the chatbot and returns the answer with proper attribution.

## Use Cases

### Customer Support

Your support team uses Claude Desktop:

```
Connect to our-company chatbot and help me answer this customer question:
"Can I get a refund after 30 days?"
```

Claude uses your official policies to respond correctly.

### Research & Comparison

Compare multiple vendors:

```
Connect to vendor-a chatbot and ask about their API rate limits.
Then connect to vendor-b and ask the same question.
Compare the answers.
```

### Internal Knowledge Base

Your team accesses company knowledge:

```
Connect to internal-wiki chatbot.
What's our policy on remote work?
```

## Available Tools

When connected in universal mode, Claude has access to:

| Tool             | Description                                 |
| ---------------- | ------------------------------------------- |
| `connect`        | Connect to a chatbot by slug                |
| `chat`           | Send a message to the connected chatbot     |
| `list_segments`  | See available segments                      |
| `switch_segment` | Change context (e.g., "sales" to "support") |
| `get_context`    | Get chatbot metadata and capabilities       |

## Example Session

```
User: Connect to animam-ai chatbot

Claude: I've connected to the Animam chatbot. This is the official
support bot for Animam.ai. It can help with:
- Pricing questions
- Technical documentation
- Integration guides
Available segments: default, developers, enterprise

User: What's the difference between Pro and Agency plans?

Claude: According to the Animam chatbot:

The Pro plan ($79/month) includes:
- 2,000 conversations/month
- 10 segments
- Analytics
- Priority support

The Agency plan ($199/month) includes:
- 10,000 conversations/month
- Unlimited segments
- White-label option
- Dedicated support
- Custom domain

User: Does Agency include MCP access?

Claude: Yes, the Agency plan includes full MCP access for both:
- MCP Builder (manage your chatbot from Claude Code)
- MCP Universal (let others connect to your chatbot)
```

## Configuration Options

### Specific Tenant

Connect to a specific tenant by default:

```json theme={null}
{
  "mcpServers": {
    "acme-support": {
      "command": "npx",
      "args": ["@animam/mcp", "--mode", "universal", "--tenant", "acme-corp"]
    }
  }
}
```

### Multiple Chatbots

Configure multiple chatbots:

```json theme={null}
{
  "mcpServers": {
    "vendor-a": {
      "command": "npx",
      "args": ["@animam/mcp", "--mode", "universal", "--tenant", "vendor-a"]
    },
    "vendor-b": {
      "command": "npx",
      "args": ["@animam/mcp", "--mode", "universal", "--tenant", "vendor-b"]
    }
  }
}
```

## Availability

| Feature            | Free | Starter | Pro | Agency |
| ------------------ | ---- | ------- | --- | ------ |
| Be queried via API | ✓    | ✓       | ✓   | ✓      |
| Be queried via MCP | -    | -       | ✓   | ✓      |
| Custom rate limits | -    | -       | -   | ✓      |

## Security

* **Public chatbots** can be queried by anyone (subject to rate limits)
* **Private chatbots** require authentication via API token
* All queries are logged and count against the tenant's conversation limit

## Next Steps

<CardGroup cols={2}>
  <Card title="MCP Builder" icon="wrench" href="/mcp/introduction">
    Manage your own chatbot via MCP
  </Card>

  <Card title="API Access" icon="code" href="/for-llms/api-access">
    Query chatbots via REST API
  </Card>
</CardGroup>