Brandlio

Brandlio MCP là một máy chủ Model Context Protocol từ xa kết nối các tài khoản quảng cáo, phân tích, thương mại điện tử và doanh thu của bạn với Claude, ChatGPT, Gemini, Cursor và bất kỳ ứng dụng khách tương thích MCP nào khác.

GitHub

Tài liệu

Brandlio MCP

Your entire marketing stack, live inside any AI assistant.

Brandlio MCP is a remote Model Context Protocol server that connects your advertising, analytics, e‑commerce, and revenue accounts to Claude, ChatGPT, Gemini, Cursor, and any other MCP‑compatible client. Ask questions in plain language and get answers from your actual live data — no CSV exports, no screenshots, no copy‑paste.

Under the hood it exposes 250+ tools across 20+ platforms through a single secure endpoint, authenticated with OAuth 2.1 (no per‑user URL secrets).

https://mcp.brandlio.io

[!NOTE] This repository is public documentation for the Brandlio MCP product. It does not contain the server source code. To use Brandlio MCP you need a Brandlio account — sign up at brandlio.io.

Why Brandlio MCP
What you can do
Supported connections
Quick start
Connect your AI client
Authentication
Skills (playbooks)
Example prompts
Security & privacy
Pricing
FAQ
Documentation
Support

Why Brandlio MCP

Marketers already have AI. What they don't have is AI that can see their accounts.

One endpoint, every platform. Google Ads, Amazon, Meta, TikTok, LinkedIn, Microsoft, Shopify, Stripe, GA4, Search Console, and more — all behind a single connector URL.
Read and act. Pull performance data and create campaigns, adjust budgets, add negatives, pause underperformers, and apply recommendations — with your confirmation.
Cross‑platform in one conversation. Ask about blended CAC across Meta and Google, compare TikTok ROAS to Amazon, or reconcile paid and organic — in a single prompt.
Brand‑aware. Brandlio keeps a per‑brand memory of preferences, thresholds, actions, and outcomes so answers reflect your goals, not generic advice.
Works everywhere. Any client that speaks MCP — desktop apps, editors, and web assistants.

What you can do

Capability	Description
📊 Live reporting	Campaign, keyword, creative, placement, geo, device, and hour‑of‑day performance across every connected ad platform.
🔎 Diagnostics	Detect anomalies, find wasted spend, surface feed errors, and explain why a metric moved.
✍️ Campaign management	Create and update campaigns, ad groups/sets, ads, keywords, audiences, and extensions.
🎯 Optimization	Add negative keywords, adjust bids and budgets, apply platform recommendations, pause/enable entities.
🛒 Commerce & revenue	Orders, sales, inventory, customers, and revenue from Shopify, WooCommerce, Amazon Seller Central, and Stripe.
📈 Analytics & SEO	Traffic, acquisition, top pages, search queries, CTR, and rankings from GA4 and Search Console.
🧠 Skills	One‑shot “playbooks” for weekly reports, search‑term negatives, RSA rewrites, and account diagnostics.
🗂️ Workspace	Read/write Google Drive, Sheets, Calendar, Tag Manager, and BigQuery for reporting workflows.

See the full tool reference →

Supported connections

Connect only the accounts you use. Everything is authorized through OAuth (or an API key where the platform requires it) and managed from your Brandlio dashboard.

Advertising

Google Ads · Microsoft Advertising (Bing) · Meta (Facebook & Instagram) · Amazon Ads · TikTok Ads · LinkedIn Ads · Pinterest Ads · Snapchat Ads · Reddit Ads

Analytics & Search

Google Analytics 4 (GA4) · Google Search Console

E‑commerce & product feeds

Shopify · WooCommerce · Amazon Seller Central (SP‑API) · Google Merchant Center

Payments

Stripe

Google Workspace & content

YouTube (Data + Analytics) · Google Business Profile · Google Drive · Google Sheets · Google Calendar · Google Tag Manager · Google BigQuery

Full breakdown of what each integration exposes: connections →

Quick start

Create a Brandlio account at brandlio.io and sign in.
Connect your platforms from the Brandlio dashboard (OAuth for most; API key for a few). Connect as many or as few as you like.
Add the connector to your AI client using the URL below and complete the browser sign‑in when prompted:
```
https://mcp.brandlio.io
```
Start asking. Your live marketing data is now available in every conversation.

Connect your AI client

The connector URL is the same everywhere: https://mcp.brandlio.io. The first time you connect, you'll complete a one‑click browser OAuth sign‑in.

Claude (web & desktop)

Settings → Connectors → Add custom connector → paste the URL → Connect and finish the sign‑in.

Claude Code

claude mcp add --transport http brandlio https://mcp.brandlio.io

Then run /mcp inside Claude Code and authenticate in the browser.

Cursor

Add to ~/.cursor/mcp.json (or Settings → MCP → Add):

{
  "mcpServers": {
    "brandlio": {
      "url": "https://mcp.brandlio.io"
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "brandlio": {
      "type": "http",
      "url": "https://mcp.brandlio.io"
    }
  }
}

Windsurf, ChatGPT, Gemini & others

Any MCP‑capable client works. Add Brandlio as a custom / remote MCP server using the same URL and complete the OAuth flow. Step‑by‑step instructions for each client live in docs/clients.md →.

Using a client that can't run a browser OAuth flow? Brandlio also supports Personal Access Tokens (header or URL mode). See Authentication.

Authentication

Brandlio MCP supports two ways to connect:

OAuth 2.1 (recommended) — PKCE‑based browser sign‑in. Nothing sensitive lives in your client config; you connect once and Brandlio manages token refresh. This is the right choice for Claude, Cursor, VS Code, and most clients.
Personal Access Token (PAT) — for automation and clients that can't do interactive OAuth. Use it as a Bearer header against https://mcp.brandlio.io, or embed it in a URL for clients that only accept a plain URL:
```
https://mcp.brandlio.io/t/<your-token>
```
PATs can be scoped to a single brand and are rate‑limited and audit‑logged.

Full details, OAuth discovery endpoints, and security notes: authentication →

Skills (playbooks)

Skills are pre‑built, multi‑step workflows the AI can run on request. Ask for one by name, or call list_skills to browse them.

Skill	What it does
Amazon weekly report	A polished last‑7‑days Amazon Ads report: headline KPIs, top campaigns/keywords, wasted spend, and recommended actions.
Amazon SP: optimize from recommendations	Audits Sponsored Products (recommendations + search terms) and applies safe optimizations after you confirm.
Google Ads: negatives from search terms	Finds wasteful search queries and adds them as negative keywords (with confirmation).
Google Ads: RSA rewrite	Drafts stronger responsive search ad headlines/descriptions grounded in performance and brand voice, then creates a new (paused) RSA.
Ad account performance analyzer	Diagnoses why performance moved (sales, CTR, conversions, ROAS, ACOS) across any connected ad platform.

More detail: skills →

Example prompts

Which campaigns are above my $25 CAC threshold right now?
What's my Amazon ACOS this week vs last week?
Where should I shift budget this week based on ROAS?
Which Amazon search terms are getting clicks but no conversions?
Are there any Merchant Center feed errors I need to fix?
Compare my Search Console CTR this month vs last month.
What's my blended CAC across Meta and Google this week?
Run the Amazon weekly report for Acme Coffee.

Security & privacy

OAuth 2.1 + PKCE — no long‑lived URL secrets required to connect.
Scoped access — connect only the platforms you choose; brand‑scoped PATs limit a token to a single brand.
You stay in control — write actions (creating campaigns, changing budgets, pausing entities) are surfaced for your confirmation by the assistant before they run.
Encrypted credentials — platform tokens are encrypted at rest.
Auditing & rate limits — PAT usage is audit‑logged and rate‑limited.

Read more in authentication → Security.

Pricing

Start free, upgrade when you need writes and more accounts. All paid plans include a 30‑day free trial (no card required for Free). Annual billing saves two months.

Plan	Price	Ad accounts	Data pulls	Write ops / mo	Support
Free	$0 forever	2	Limited (read‑only)	—	Community
Starter	$49/mo	5	Unlimited	50	Email
Pro	$99/mo	15	Unlimited	200	Email + chat
Business	$199/mo	Unlimited	Unlimited	500	Priority

Write operations are a single shared pool across every platform (creating/updating campaigns, adding negatives, pausing entities, and other changes). Read and reporting pulls are unlimited on paid plans.
Credit add‑ons (with rollover) are available on all paid plans: 500 credits ($25) · 2,000 ($80) · 10,000 ($300) · 50,000 ($1,000). Check your balance any time by asking the assistant (get_credit_balance).
Full Platform — from $299/mo — adds unlimited writes and Intelcore brand intelligence.

See current plans and sign up at mcp.brandlio.io/pricing.

FAQ

Do I need to be a developer? No. If you can add a connector in Claude or paste a URL, you can use Brandlio MCP.

Which AI clients are supported? Any client that supports the Model Context Protocol — Claude (web/desktop/Code), Cursor, VS Code (Copilot), Windsurf, ChatGPT, Gemini, and more.

Can the AI change my campaigns, or only read data? Both. Brandlio exposes read tools and management tools. The assistant will confirm consequential write actions with you before executing them.

Do I have to connect every platform? No. Connect only what you need; you can add more later from the dashboard.

Is my data used to train models? Brandlio passes your live account data to the AI client you connect. Review brandlio.io for the current privacy policy and terms.

A connection says “not connected” — what now? Open your Brandlio dashboard and (re)connect that platform. The assistant will have data on the next turn.

Documentation

Doc	Contents
Connections	Every supported platform and what data/actions each exposes.
Tool reference	The full catalog of 250+ tools, grouped by platform.
Authentication	OAuth 2.1, Personal Access Tokens, discovery endpoints, security.
Client setup	Step‑by‑step connection guides for each AI client.
Skills	The built‑in playbooks and how to run them.

Support

🌐 Website: brandlio.io
🔌 MCP endpoint: https://mcp.brandlio.io
💬 In‑app: ask the assistant to submit_feedback to send us a note directly.

_{Brandlio MCP is a Brandlio product. Platform names and trademarks belong to their respective owners. See LICENSE.}