Skip to main content

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.

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.
This is different from the MCP Builder which is for managing your own chatbot. MCP Universal is for querying any chatbot as a user.

​
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: 
{
  "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:
ToolDescription
connectConnect to a chatbot by slug
chatSend a message to the connected chatbot
list_segmentsSee available segments
switch_segmentChange context (e.g., “sales” to “support”)
get_contextGet 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: 
{
  "mcpServers": {
    "acme-support": {
      "command": "npx",
      "args": ["@animam/mcp", "--mode", "universal", "--tenant", "acme-corp"]
    }
  }
}

​
Multiple Chatbots

Configure multiple chatbots: 
{
  "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

FeatureFreeStarterProAgency
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

MCP Builder

Manage your own chatbot via MCP

API Access

Query chatbots via REST API