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.

MCP Tools

Complete reference of tools available via the Animam MCP server.

Corpus

corpus_list

List corpus entries. Parameters:
ParamTypeDescription
segmentstringFilter by segment (optional)
limitnumberMax count (default: 20)
Example:
You: List entries in the pricing segment

Claude: [Calls corpus_list with segment="pricing"]

Here are the 3 entries in the "pricing" segment:
1. Monthly rates - "Starter: $29, Pro: $49..."
2. FAQ Pricing - "Payment is monthly..."
3. Annual discount - "Save 20%..."

corpus_add

Add an entry to the corpus. Parameters:
ParamTypeRequiredDescription
titlestringYesEntry title
contentstringYesContent
segmentstringNoAssociated segment
prioritynumberNoPriority 1-10
Example:
You: Add to corpus: title "Shipping", content "Free shipping over $50", segment "checkout"

Claude: [Calls corpus_add]

I've added the "Shipping" entry to the corpus in the "checkout" segment.

corpus_update

Modify an existing entry. Parameters:
ParamTypeRequiredDescription
idstringYesEntry ID
titlestringNoNew title
contentstringNoNew content
segmentstringNoNew segment
prioritynumberNoNew priority

corpus_delete

Delete an entry. Parameters:
ParamTypeRequired
idstringYes

Conversations

conversations_list

List recent conversations. Parameters:
ParamTypeDescription
limitnumberMax count (default: 10)
segmentstringFilter by segment
Example:
You: Show the last 5 conversations

Claude: [Calls conversations_list with limit=5]

Recent conversations:
1. 2 hours ago - "What are your prices?" (segment: pricing)
2. 3 hours ago - "How do I return a product?" (segment: support)
...

conversations_get

Retrieve a complete conversation. Parameters:
ParamTypeRequired
idstringYes

Chat

chat

Send a message to the chatbot. Parameters:
ParamTypeRequiredDescription
messagestringYesMessage to send
segmentstringNoSegment to use
Example:
You: Test the chatbot with "Hello, what are your hours?"

Claude: [Calls chat]

Chatbot response:
"Hello! We're open Monday to Friday, 9am to 6pm.
Saturday 10am to 4pm. How can I help you?"

Settings

settings_get

Retrieve tenant settings. Example:
You: What are the current chatbot settings?

Claude: [Calls settings_get]

Current configuration:
- Name: Sophie
- Title: Sales Assistant
- Tone: Professional
- Formality: Formal
- Emojis: Disabled
- Color: #6366f1

settings_update

Modify settings. Parameters:
ParamTypeDescription
personality.namestringBot name
personality.tonestringTone (professional, casual, friendly)
personality.formalitystringformal or informal
personality.emojisbooleanUse emojis
widget.primaryColorstringHex color
Example:
You: Change the bot name to "Emma" and enable emojis

Claude: [Calls settings_update]

I've updated the settings:
- Name: Sophie -> Emma
- Emojis: Disabled -> Enabled

Common workflows

Update corpus from a doc

You: Read the FAQ.md file and add each Q&A to the corpus

Claude: [Reads file, then calls corpus_add multiple times]

I've added 12 entries to the corpus from FAQ.md.

Conversation analysis

You: What are the most frequent questions this week?

Claude: [Calls conversations_list, analyzes patterns]

Top 5 questions:
1. "What are your prices?" (23 times)
2. "International shipping?" (18 times)
...

Test and iterate

You: Test the chatbot on the pricing segment, then improve the pricing response

Claude: [Calls chat, then corpus_update]

Test completed. I've enriched the "Pricing" entry with more details about each plan's features.