# Stammer.ai MCP

> Stammer.ai MCP Server lets your AI client manage an entire white-label chatbot agency. You can programmatically list all chatbots, update knowledge bases with new URLs or Q&A pairs, and monitor sub-account performance—all without opening a dashboard. This is for developers who need to orchestrate multiple custom AI agents from one chat window.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** stammer-ai, white-label-ai, chatbot-builder, ai-agency-tools, knowledge-base-api, reseller-platform, conversational-ai, mcp

## Description

Stammer.ai MCP Server lets your agent manage an entire white-label chatbot agency without ever opening a dashboard. This server gives you full command over every aspect of the Stammer.ai backend, letting your AI client treat your network like pure operational infrastructure. You'll use this when you need to programmatically list agents and update knowledge bases from one single chat window.

**Managing Chatbots**: To get a bird's-eye view, start by calling `list_chatbots`, which gives you an index of every managed AI agent in the whole system. If you need specifics on one bot, use `get_chatbot` to pull detailed profile metadata and configuration for that specific chatbot instance. You can also spin up new bots using `create_chatbot`, initializing a brand-new AI chat agent right through your conversation.

**Updating Knowledge Bases**: When the facts change, you don't want to mess with menus; you just tell your client what needs adding. To beef up a bot’s intelligence, use `add_qa` to inject specific question-and-answer pairs directly into its knowledge base. If a whole website changes, run `add_url`; this scrapes content from an external URL and adds it as new facts to the chatbot's memory. You can check what's already there by calling `list_knowledge_base`, which provides an index of all existing items for a specific bot, or pull everything into one dump using `get_knowledge_base`.

**Agency Oversight and Monitoring**: For managing your whole resale operation, you need visibility into the accounts and users. Start by listing every sub-account ID associated with your agency structure using `list_sub_accounts`. If you need deep details on a single client's account setup, call `get_sub_account` with that specific ID. You can also get an index of all user accounts managed under the platform via `list_users`, or grab full lists of those users and their profiles using `list_users`. For tracking conversation quality, use `list_messages` to retrieve the most recent chat message history and conversational logs for any given bot.

Here's how you run it: You simply direct your AI client to perform these actions. Need to check a user account? Use `get_sub_account`. Want to see all agents running? Call `list_chatbots`. If the documentation needs new facts, fire off an `add_qa` command. It's pure automation; you never have to switch tabs or navigate menus to run these operations.

## Tools

### add_qa
Adds a specific question-and-answer pair to a chatbot's knowledge base.

### add_url
Scrapes content from an external website URL and adds it to the chatbot's knowledge base.

### create_chatbot
Initializes a brand new AI chatbot instance within your agency account.

### get_chatbot
Retrieves specific metadata and configuration details for one named chatbot.

### get_knowledge_base
Pulls the full list of facts (Q&A pairs, scraped content) stored in a given chatbot's knowledge base.

### get_sub_account
Retrieves all account details for a specific sub-account ID within your agency structure.

### list_chatbots
Lists every currently managed AI agent (chatbot) in the entire Stammer.ai system.

### list_knowledge_base
Provides an index listing of all current knowledge base items for a specified chatbot.

### list_messages
Retrieves the most recent chat message history and conversational logs for a given bot.

### list_sub_accounts
Lists every white-label sub-account ID associated with your agency.

### list_users
Provides a list of all user accounts managed under the agency platform.

## Prompt Examples

**Prompt:** 
```
List all active chatbots in my Stammer.ai account.
```

**Response:** 
```
I've retrieved your chatbots. You have 3 active bots online: 'Customer Support Lead', 'Real Estate Assistant', and 'Onboarding Specialist'. Which one would you like to update?
```

**Prompt:** 
```
Show me the performance analytics for all deployed AI chatbots with conversation metrics.
```

**Response:** 
```
5 deployed chatbots. "Sales Assistant" (GPT-4): 1,234 conversations this month, 78% resolution rate, avg 4.2 messages per conversation, lead capture rate 34%. "Support Bot" (GPT-4): 2,890 conversations, 85% resolution, avg 6.1 messages, ticket reduction 45%. "FAQ Helper" (GPT-3.5): 4,560 conversations, 92% accuracy, avg 2.3 messages. "Onboarding Guide" (GPT-4): 567 conversations, 89% completion. "Internal HR" (GPT-4): 345 conversations, 91% satisfaction. Total tokens used: 12.4M. Monthly cost: $234.
```

**Prompt:** 
```
Add 20 new FAQ entries to the Support Bot knowledge base from our latest help center articles.
```

**Response:** 
```
20 FAQ entries added to Support Bot knowledge base. Categories: Billing (5 entries), Account Management (4), Technical Setup (4), Integrations (3), Security (2), API Usage (2). Source: Help Center articles published May 1-15. Training status: complete (re-indexed in 12 seconds). Knowledge base size: 234 entries → 254 entries. Confidence threshold: maintained at 85%. Test results: 18/20 new entries correctly matched to test queries (90% accuracy). 2 entries flagged for review (ambiguous intent overlap with existing entries).
```

## Capabilities

### Manage Chatbots
List all managed chatbots and retrieve detailed profile metadata for any specific chatbot.

### Update Knowledge Bases
Add new question-and-answer pairs or entire website URLs to a bot's knowledge base using natural conversation.

### Monitor Accounts and Users
List all sub-accounts and users associated with your agency, giving you an overview of your resale operations.

### Review Chat History
Retrieve recent chat messages and monitor conversational logs for a specific chatbot instance.

## Use Cases

### The Bot Needs New Facts
A marketing developer needs the Support Bot to know about a new product feature. Instead of logging into the admin dashboard, they simply tell their agent: 'Add 5 Q&As for Product X.' The agent runs `add_qa`, and the bot's knowledge base is updated immediately.

### Checking Account Health
An agency owner needs to see if a specific client account (`client-xyz`) has been active or if their assigned bots are running. The agent calls `get_sub_account` and then `list_chatbots`, giving the owner a complete, verifiable status report in seconds.

### Debugging an Interaction
A customer service team member gets a complaint that 'Bot B' gave wrong advice. They instruct their agent to run `list_messages` for Bot B and the specific user ID, pulling up the exact transcript needed to fix the issue.

### Scaling Chatbot Deployment
A product manager wants to test three new versions of a bot before launch. They use `list_chatbots` to see what's running and then call `create_chatbot` three times, deploying the required agents without manual clicks.

## Benefits

- **Real-time Oversight:** Instead of clicking through multiple tabs to check performance, use `list_chatbots` and `get_chatbot` to pull the status and metadata for your entire bot fleet in one command.
- **Automated Content Updates:** Feeding bots data shouldn't be manual. Use `add_url` or `add_qa` to inject new corporate documents or FAQs directly from the chat, keeping knowledge bases current instantly.
- **Audit Trail Access:** When a client complains, don't hunt through emails. Run `list_messages` to pull the full conversational history for any bot, providing immediate evidence of interaction quality.
- **Agency Structure Clarity:** Quickly understand who has access and what they own. Use `list_sub_accounts` or `get_sub_account` to audit your entire client base's permissions.
- **Bot Lifecycle Control:** Need a new function? Use `create_chatbot` to spin up an agent instantly, bypassing the need to navigate the separate web portal just for deployment.

## How It Works

The bottom line is that you manage complex chatbot infrastructure by talking to it, not by clicking through dashboards.

1. Subscribe to the Stammer.ai server on Vinkius Marketplace.
2. Enter your API Key from your agency dashboard into your preferred AI client settings (Claude, Cursor, etc.).
3. Directly instruct your agent: 'List all active chatbots' or 'Add a Q&A pair for the Support Bot.' The agent executes the necessary tool call and returns the data.

## Frequently Asked Questions

**How do I list all chatbots using the Stammer.ai MCP Server?**
You run `list_chatbots`. This tool returns an index of every chatbot ID and name managed under your agency account, giving you a full roster.

**What if I want to add a new FAQ using the Stammer.ai MCP Server?**
Use the `add_qa` tool. You provide the question and the answer directly in your prompt, and the agent injects that pair into the target chatbot's knowledge base.

**Can I list all users on my agency platform?**
Yes. Run `list_users`. This tool gives you a comprehensive list of every user account associated with your white-label sub-accounts for auditing purposes.

**How do I check the history of a specific bot?**
Use `list_messages` and provide the target chatbot ID. It retrieves recent chat logs, letting you see the conversation flow immediately without leaving your client.

**What credentials do I need to use the `list_sub_accounts` tool?**
You must provide a valid Stammer.ai API key associated with your agency dashboard. This key grants access to all white-label sub-account details under your organizational scope.

**Should I use the `add_url` tool or manually input data using `add_qa`?**
Use `add_url` when you have entire websites or help center sections you want to scrape and index. For specific, high-priority facts that need immediate inclusion, manual entry via `add_qa` is faster.

**How can I check the operational status of a chatbot using `get_chatbot`?**
The `get_chatbot` tool returns a detailed profile including its current 'status' field. This tells you if the bot is active, paused, or undergoing maintenance.

**Does the `get_sub_account` tool respect granular permission boundaries?**
Yes, the server respects your API key permissions. The data returned by `get_sub_account` will be limited only to sub-accounts you have been granted access to within the agency.

**How do I find my Stammer.ai API Key?**
Log in to your Stammer.ai agency dashboard and you will find your unique secret API Key in the API settings or account management section.