@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

BotUyo MCP Server