Birch MCP: talk with your Birch data from Claude, ChatGPT and other AI tools

Birch MCP brings your rule setup, execution logs, and account structure to the AI tools you work with

Connect Birch MCP

How to connect Birch to your AI tool

1. Open connector settings

On Pro and Max, go to Customize → Connectors. On Team and Enterprise, go to Organization settings → Connectors.

2. Add a custom connector

Click + → Add custom connector. Name it Birch and paste the URL: . Click Connect.

3. Sign in to connect

Sign in with your Birch account.

Analyze your automation the way you analyze everything else

Use Cases

Birch MCP is one of the tools Claude can reach. Ask a question that pulls your automation data alongside your analytics, your project tracker, your planning docs — whatever else you’ve connected. The context lives in one conversation instead of four tabs.

Ask “Audit my automations — what’s actually working?” Claude reads every rule on the account, checks execution history, and classifies them: firing usefully, running but never matching, erroring silently, or sitting disabled. Every mature account accumulates zombie rules — find them before they cost you.

Let Claude read your execution logs and trace which rule fired, what triggered it, and how rules interacted — the investigation that used to mean opening Birch and piecing it together yourself. Now it’s a question in the same conversation where you’re already planning your day. Schedule it for a regular check-in.

Hold to pause auto-switching

Tool directory

6 tools · Write

Rule management

Manage existing rules across Meta, Google, TikTok, and Snapchat: enable or disable, rename, duplicate, move between folders, change ad accounts, and replace entity filters.

6 tools · Read-only

Rules & logs

The core of the read surface. List a workspace’s automation rules (with optional folder filtering) and their folder structure, pull one rule’s full logic in prose (conditions, schedule, filters, targeted entities), inspect available entity filters, then list its execution history and drill into one run to see exactly which entities matched, what fired, and any errors.

2 tools · Read-only

Workspace & accounts

List the workspaces the connected user can access, then the ad accounts under a workspace for a given platform.

1 tool · Read-only

Metrics catalog

Search Birch’s metric catalog by description to find metric IDs, labels, platforms, and features.

3 tools · Read-only

Stage (creative pipeline)

Check Stage task status (upload vs. create, progress, failure reason), see which files a task uploaded and their platform media IDs, and list the ads a create task actually produced.

1 tool · Read-only

Help

Keyword/semantic search over the Birch help center, so an AI client can answer product questions from real docs instead of guessing.

  • Rules & logs

    list_automation_rules

    Lists rules on an ad account — ID, name, level, enabled, check interval, folder. Filterable by folder

  • Rules & logs

    get_rule_details

    Full rule logic: tasks (action + condition as prose), schedule, filters, targeted entities

  • Rules & logs

    list_rule_logs

    Execution log summaries — when the rule ran, entities evaluated/acted on/errored

  • Rules & logs

    get_rule_log

    Detailed per-entity outcomes — actions applied, status changes, condition results, errors. Filterable

  • Rules & logs

    list_rule_folders

    Folder tree for automation rules — ID, name, parent_id for subfolders

  • Rules & logs

    get_rule_filter_options

    Lists available entity filter options for a rule.

  • Workspace & accounts

    list_workspaces

    Lists all workspaces the user can access, with IDs and currency

  • Workspace & accounts

    list_ad_accounts

    Lists ad accounts in a workspace — Birch ID, name, currency, timezone, access status

  • Stage

    list_stage_tasks

    Stage tasks — status, progress counts, error messages. Filterable by status and task type

  • Stage

    list_stage_uploads

    Creative files uploaded by a Stage task — file name and platform media ID

  • Stage

    list_stage_created_ads

    Ads created by a Stage task — ad name, platform ad/adset IDs, creation time

  • Metrics catalog

    search_metrics

    Natural-language search of Birch’s metric catalog — metric ID, label, platform, feature

  • Help

    search_help

    Keyword search across Birch Help Center articles

  • Rule management · Write

    set_rule_status

    Enable or disable an existing rule.

  • Rule management · Write

    set_rule_ad_accounts

    Replace the ad accounts a rule runs on.

  • Rule management · Write

    rename_rule

    Rename an existing rule.

  • Rule management · Write

    move_rule

    Move a rule into a folder or to the top level.

  • Rule management · Write

    duplicate_rule

    Copy a rule within or across workspaces.

  • Rule management · Write

    set_rule_filters

    Replace a rule’s full entity filter setup.

Two ways to work with your automation

Birch AI

Explore

Assistant inside the Birch product. It reads your rules and account data and helps you work faster without leaving Birch.

Birch MCP

Brings your real data to Claude and other AI clients. Use it when you’re already working in Claude — alongside your other connected tools. You don’t have to switch to Birch to understand what your automation did.

Birch AI Birch MCP Meta MCP

Learn the difference

A breakdown across six workflows — auditing rules, reading logs, building automation, benchmarking, and more.

See the comparison

Already in progress

Rule creation and editing

Ask your AI to adjust a threshold, update a condition, or disable a stale rule — and approve the change before it takes effect

Ad creation

Ask your AI to upload creatives and create ads across Meta, TikTok, and Snapchat using Stage.

FAQ

What is MCP?

MCP stands for Model Context Protocol — an open standard that lets AI tools connect to external systems and work with their data. Birch MCP uses it to give AI clients read access to your automation rules, execution logs, and account structure.

Where can I use Birch MCP?

Anywhere that supports the MCP standard. Claude is the most common client, but any MCP-compatible tool can connect. You add Birch MCP as a connector in your tool’s settings, sign in, and it becomes available in that conversation — no need to pick a specific AI client to use it.

How is this different from Meta MCP?

They read different things. Meta MCP reads campaign data and reporting from Meta directly. It also has access to Meta Ads library and Meta Help Center. Birch MCP reads your automation rules — the logic that governs how those campaigns are managed inside Birch. You can use both in the same conversation for different stages of your workflow.

Do I need technical skills to set it up?

No. You add Birch MCP in your AI client’s connector settings, sign in with your Birch account, and you’re connected. No API keys, no code.

Can Birch MCP change my rules or my account?

Birch MCP can manage existing rules: enable or disable them, rename, duplicate, move them between folders, change their ad accounts, and replace entity filters. It cannot create new rules, edit budgets or rule conditions, or change other account settings.

What data does Birch MCP see when I connect?

Your workspaces, ad accounts, rule configurations (conditions, thresholds, schedules, actions), execution logs, folder structure, and Stage task metadata. It doesn’t see your creative content, billing information, or personal data beyond what’s already visible in your Birch workspace.

I already use Birch AI. Why would I also use the MCP?

Birch AI works inside the Birch product. Birch MCP works inside your own AI client — where you might already be talking to your analytics, your project tracker, or your team chat. If your daily workflow lives outside Birch, the MCP brings your automation context to where you already are. They’re complementary.

Your rules, logs, and accounts — known by your AI tool

Pressure-test your automation, diagnose what happened overnight, and find the gaps — all from one conversation.

Book demo
14days free trial
Cancel anytime
No credit card required
Try Birch