Model Context Protocol · Enterprise feature

Control Botyoo from
any AI agent

Botyoo ships a native MCP server. Connect Claude, Cursor, Kiro, or Windsurf to your account and manage automations, pull contacts, and read analytics — all in plain English.

Get your API key View Enterprise plan
Your MCP endpoint Works with any MCP client
https://mcp.botyoo.com/mcp/botyoo_YOUR_API_KEY

Replace botyoo_YOUR_API_KEY with your key from the dashboard.

Setup guide

Choose your AI tool and follow the steps.

Claude.ai setup

  1. 1

    Open claude.ai and go to Settings → Integrations

  2. 2

    Click Add Integration

  3. 3

    Paste your MCP URL: https://mcp.botyoo.com/mcp/botyoo_YOUR_KEY

  4. 4

    Click Save — Claude will discover the tools automatically

Config

URL to add in Claude.ai integrations:

https://mcp.botyoo.com/mcp/botyoo_YOUR_KEY

Claude auto-discovers all 8 tools once the URL is saved.

Available tools

All 8 tools are discovered automatically once connected. No setup needed per tool.

list_instagram_accounts
List all connected Instagram accounts for this workspac…

List all connected Instagram accounts for this workspace.

Parameters

No parameters — call with empty object {}

Returns

Array of connected accounts with their IDs, usernames, and connection status.

list_automations
List all automations in the workspace with active/inact…

List all automations in the workspace with active/inactive status and basic metrics.

Parameters

No parameters — call with empty object {}

Returns

Array of automations with IDs, names, status, trigger type, and engagement counts.

create_comment_automation
Create a new keyword-triggered comment automation with …

Create a new keyword-triggered comment automation with auto-reply, follow gate, email collection, and DM prompt.

Parameters

name string required Name of the automation
keywords string[] required Keywords that trigger this automation
prompt object required JSON block for the DM prompt (text or button layout)
isFollowed boolean optional Require the user to follow before sending the main DM (default: false)
isEmailCollect boolean optional Ask for email before sending the main DM (default: false)

Returns

Created automation object with its new ID.

update_automation_status
Turn an automation ON or OFF. Useful for pausing campai…

Turn an automation ON or OFF. Useful for pausing campaigns without deleting them.

Parameters

automationId string required The ID of the automation
active boolean required true to activate, false to pause

Returns

Updated automation object.

get_analytics
Get engagement analytics for an automation — DMs sent, …

Get engagement analytics for an automation — DMs sent, comments replied, open rates.

Parameters

automationId string required The ID of the automation

Returns

Analytics object with DM counts, comment reply counts, and delivery rates.

export_emails
Get a full list of contacts and their collected emails …

Get a full list of contacts and their collected emails for a specific automation.

Parameters

automationId string required The ID of the automation

Returns

Array of contacts with handle, email, and capture timestamp.

get_contacts
List contacts captured by an automation. Includes IG ha…

List contacts captured by an automation. Includes IG handle, follower count, and email status.

Parameters

automationId string required The ID of the automation
limit number optional Max contacts to return (default: 50)

Returns

Array of contact objects.

get_recent_dms
View the most recent direct messages sent by a specific…

View the most recent direct messages sent by a specific automation.

Parameters

automationId string required The ID of the automation
limit number optional Max messages to return (default: 10)

Returns

Array of DM events with recipient handle, message content, and timestamp.

Example prompts

Copy these into Claude or Cursor to get started.

Analytics

"List all my active automations and tell me which one has the highest DM delivery rate"

Create

"Create a comment automation called 'Free Guide' that triggers on 'guide', 'link', 'send me' — send a text DM with the download link"

CRM

"Show me the last 20 contacts captured by automation ID abc123 and export their emails"

Management

"Pause all automations that have a DM delivery rate below 80%"

Analytics

"Get analytics for my top 3 automations and give me a comparison table"

Create

"Create a follow-gated automation: only send the promo link after the user follows us"

Ready to connect?

Get your API key from the Botyoo dashboard and add it to your AI tool in under 2 minutes.

Get your API key MCP is on Enterprise →

MCP server access is available on the Enterprise plan. See all plans