BotUyo Server

Create and manage BotUyo AI agents directly from your AI coding tools — no cloning, no building.

npm version

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

git clone https://github.com/MarcoAR1/botuyo-mcp.git
cd botuyo-mcp
npm install
npm run build

Test with MCP Inspector

BOTUYO_API_KEY=pk_live_... npm run inspect

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Please note that this project follows a Code of Conduct.

Security

To report a vulnerability, see SECURITY.md.

License

MIT © BotUyo