Add it to Claude Code
claude mcp add -e "BOTUYO_API_KEY=${BOTUYO_API_KEY}" botuyo -- npx -y @botuyo/mcpBOTUYO_API_KEYMake your agent remember this setup
botuyo's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Direct management of AI agents without manual cloning or building
- Configure agent identities, tones, and languages via natural language
- Manage conversation stages and tool integrations programmatically
- Check agent status and channel connectivity directly from the IDE
- Publish and unpublish agents through simple commands
Tools 9
list_agentsList all agents associated with the tenant.get_agentRetrieve the full configuration of a specific agent.get_agent_statusGet the channel status and admin link for an agent.create_agentCreate a new AI agent.update_agentUpdate an agent's identity, including tone and language.upsert_stageCreate or edit a conversation stage for an agent.list_available_toolsList all tools available to the tenant.update_enabled_toolsEnable or disable specific tools on an agent.publish_agentPublish or unpublish an agent.Environment Variables
BOTUYO_API_KEYrequiredThe API key obtained from the BotUyo admin panel.Try it
Original README from MarcoAR1/botuyo-mcp
@botuyo/mcp — BotUyo MCP Server
Create and manage BotUyo AI agents directly from your AI coding tools — no cloning, no building.
Quickstart
1. Get your API Key
Go to admin.botuyo.com → your tenant → Settings → API Keys and copy your pk_live_... key.
2. Add to your MCP client
The config is the same for all MCP-compatible tools:
{
"mcpServers": {
"botuyo": {
"command": "npx",
"args": ["-y", "@botuyo/mcp"],
"env": {
"BOTUYO_API_KEY": "pk_live_your_key_here"
}
}
}
}
Where to put this config:
| Tool | Config file |
|---|---|
| Antigravity (VS Code) | VS Code settings → MCP → Add server |
| Claude Desktop | ~/.config/claude/claude_desktop_config.json |
| Cursor | .cursor/mcp.json in your project |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Continue | .continue/config.json |
3. Start building agents
Once connected, ask your AI assistant things like:
"Create a new agent called 'Soporte' for my tenant" "Update Mar's objective to focus on sales" "Add a welcomeStage that greets guests in Spanish" "Enable the EscalateToHuman and SearchKnowledgeBase tools on Mar" "Publish the agent"
Available Tools
| Tool | Description | Role Required |
|---|---|---|
list_agents |
List all agents | viewer+ |
get_agent |
Get full agent config | viewer+ |
get_agent_status |
Channel status + admin link | viewer+ |
create_agent |
Create a new agent | developer+ |
update_agent |
Update identity (tone, language, etc.) | developer+ |
upsert_stage |
Create/edit a conversation stage | developer+ |
list_available_tools |
List tools available to your tenant | viewer+ |
update_enabled_tools |
Enable/disable tools on an agent | developer+ |
publish_agent |
Publish or unpublish an agent | developer+ |
Roles
| Role | Read | Write | Publish |
|---|---|---|---|
owner |
✅ | ✅ | ✅ |
admin |
✅ | ✅ | ✅ |
developer |
✅ | ✅ | ✅ |
viewer |
✅ | ❌ | ❌ |
Channel Integrations
Connecting channels (WhatsApp, Instagram, Telegram, Web) must be done from admin.botuyo.com — they require interactive flows (QR scans, OAuth, etc.).
Use get_agent_status to check which channels are connected. It returns a direct link to the admin panel for any missing channel.
Build from source
cd packages/mcp
npm install
npm run build
Test with MCP Inspector
cd packages/mcp
BOTUYO_API_KEY=pk_live_... npm run inspect