ChipsAI MCP Server
Connects Claude to ChipsBot's full chatbot management API. You get tools to create and configure bots, upload documents to their knowledge base via LlamaParse, send messages, pull analytics, and manage conversations. The RAG pipeline is configurable per bot with HyDE, reranking via Jina, and L2 chunk injection tuning. You can also wire up bot-to-bot routing where an orchestrator delegates queries to specialists based on role matching. Auth works via API key or username/password JWT. Useful if you're running ChipsBot chatbots and want to adjust prompts, swap models, tune retrieval thresholds, or debug conversation flows without leaving your editor.
- tools
- 25
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Mar 12, 2026
Tools
25 toolsPublic tool metadata for what this MCP can expose to an agent.
list_chatbotsList all chatbots for the authenticated user
List all chatbots for the authenticated user
No parameter schema in public metadata yet.
get_chatbotGet full chatbot details (prompt, model, colors, etc.)
Get full chatbot details (prompt, model, colors, etc.)
No parameter schema in public metadata yet.
create_chatbotCreate a new chatbot (returns embed script tag)
Create a new chatbot (returns embed script tag)
No parameter schema in public metadata yet.
update_chatbotUpdate chatbot fields (name, prompt, model, theme, colors, etc.)
Update chatbot fields (name, prompt, model, theme, colors, etc.)
No parameter schema in public metadata yet.
delete_chatbotSoft-delete (deactivate) a chatbot
Soft-delete (deactivate) a chatbot
No parameter schema in public metadata yet.
get_chatbot_configGet public widget configuration
Get public widget configuration
No parameter schema in public metadata yet.
get_chatbot_analyticsGet analytics: messages, sessions, daily stats, devices, countries
Get analytics: messages, sessions, daily stats, devices, countries
No parameter schema in public metadata yet.
upload_documentUpload PDF/DOC/DOCX to a chatbot's knowledge base (LlamaParse)
Upload PDF/DOC/DOCX to a chatbot's knowledge base (LlamaParse)
No parameter schema in public metadata yet.
list_conversationsList conversations, optionally filtered by chatbot
List conversations, optionally filtered by chatbot
No parameter schema in public metadata yet.
create_conversationCreate a new conversation
Create a new conversation
No parameter schema in public metadata yet.
get_conversationGet conversation details
Get conversation details
No parameter schema in public metadata yet.
update_conversationUpdate conversation title
Update conversation title
No parameter schema in public metadata yet.
delete_conversationDelete a conversation and all messages
Delete a conversation and all messages
No parameter schema in public metadata yet.
get_conversation_messagesGet all messages from a conversation
Get all messages from a conversation
No parameter schema in public metadata yet.
list_conversation_historyList widget conversation sessions (paginated, filter by chatbot)
List widget conversation sessions (paginated, filter by chatbot)
No parameter schema in public metadata yet.
get_session_messagesGet all messages from a widget conversation session
Get all messages from a widget conversation session
No parameter schema in public metadata yet.
send_messageSend a message and get AI response (auto-creates conversation)
Send a message and get AI response (auto-creates conversation)
No parameter schema in public metadata yet.
connect_botConnect a specialist bot to an orchestrator bot (role-based routing)
Connect a specialist bot to an orchestrator bot (role-based routing)
No parameter schema in public metadata yet.
list_bot_connectionsList all specialist bots connected to an orchestrator
List all specialist bots connected to an orchestrator
No parameter schema in public metadata yet.
update_bot_connectionUpdate role, label, description, or active status of a connection
Update role, label, description, or active status of a connection
No parameter schema in public metadata yet.
disconnect_botRemove a bot-to-bot connection
Remove a bot-to-bot connection
No parameter schema in public metadata yet.
get_rag_configGet RAG config: threshold, chunk settings, HyDE, L2, reranker, system instructions
Get RAG config: threshold, chunk settings, HyDE, L2, reranker, system instructions
No parameter schema in public metadata yet.
update_rag_configUpdate RAG config (threshold, chunk_size, chunk_strategy, HyDE, L2, reranker, etc.)
Update RAG config (threshold, chunk_size, chunk_strategy, HyDE, L2, reranker, etc.)
No parameter schema in public metadata yet.
get_user_planGet credit balance, unlimited status, usage stats
Get credit balance, unlimited status, usage stats
No parameter schema in public metadata yet.
list_ai_modelsList available AI models by provider with credit costs
List available AI models by provider with credit costs
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
CHIPSAI_EMAIL*ChipsAI account email
CHIPSAI_PASSWORD*secretChipsAI account password
Readme
ChipsAI MCP Server
MCP (Model Context Protocol) server for ChipsBot — manage chatbots, conversations, documents, bot-to-bot routing, RAG configuration, and AI models from Claude Code, Claude Desktop, or any MCP client.
Requirements
Quick Start
No installation needed with uv:
uv run --script server.py
Or install manually:
pip install "mcp[cli]" httpx
python server.py
Configuration
The server uses environment variables for authentication. API key is the recommended method — generate one from your ChipsBot dashboard.
| Variable | Description | Default |
|---|---|---|
CHIPSAI_API_KEY | Your ChipsAI API key (recommended) | — |
CHIPSAI_API_URL | API base URL | https://ai.chipsbuilder.com |
Legacy: username/password authentication
If you don't have an API key, you can use username/password instead:
Details
- Repository
- github.com/fgasparetto/chipsai-mcp
- Package
chipsai-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active