Marketing Data & Context for Claude

Documentation

How to connect and start pulling live marketing data directly into Claude.

Getting Started

Marketing Data & Context for Claude connects as an MCP (Model Context Protocol) server. Once connected, Claude can pull live data from Instagram, TikTok, YouTube, LinkedIn, Google Maps, Amazon, Google Play, Apple App Store, Meta Ads Library, Google Ads Library, Google Keyword Planner, Google Analytics 4, Google Search Console, Google Ads (your account), and Meta Ads (your account) on demand. No copy-pasting, no exports.

1
Create an account

Click here to sign up - you get 30 free credits instantly, no credit card required.

2
Connect to Claude

Follow the instructions below.

3
Ask Claude to get data

Just describe what you need in plain English - Claude handles the rest.

Connect to Claude

Connect via Claude.ai (Pro and Team plans) - once connected, it also works automatically in Claude Code and Claude Desktop.

  1. Go to claude.ai and open Settings.
  2. Navigate to ConnectorsAdd custom connector.
  3. In the Name field, enter:
Smacient
  1. In the Remote MCP server URL field, enter:
https://claude.smacient.com/mcp
  1. Click Add - you will be redirected to sign in with your Smacient account.
  2. After authorising, the connector will appear as active. Start a new chat to use it.
First time using a tool? Claude will ask you to approve each tool the first time it is used. Click Always allow to approve it permanently - you only need to do this once per tool.
Using Claude Code? Install the Smacient MCP with one command:

npm install -g @smacient/mcp && smacient-mcp setup

Then use it directly from your terminal: claude "List my GA4 properties"

Connect Google Analytics & Search Console

GA4 and Google Search Console tools require a separate one-time Google account connection. This gives Claude read-only access to your own Analytics and Search Console properties.

GA4 and GSC tools will return an error if you have not connected your Google account yet. The connection takes under a minute.
1
Go to your dashboard

Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.

2
Click "Connect" on the Google Analytics or Search Console card

You will be redirected to Google's consent screen. GA4 and Search Console share a single Google OAuth connection, so connecting once gives you access to both.

3
Return to Claude

After connecting, the tools become available immediately. Ask Claude to list your properties to confirm the connection is working.

Connect Google Ads

Google Ads tools give Claude read-only access to your Google Ads accounts - including campaign performance, search terms, spend, ROAS, video campaigns, and Performance Max. All Google Ads tools are free to use.

Google Ads tools are completely free to use. You need an active Google Ads account to connect. If your Google account has no Ads accounts, the tools will return an empty account list.
1
Go to your dashboard

Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.

2
Click "Connect" on the Google Ads card

You will be redirected to Google's consent screen. We request read-only access to your Google Ads data. We never request permission to create, edit, or delete any campaigns, ads, or budgets.

3
Return to Claude and ask it to list your Google Ads accounts

Always start with this. It returns the customer_id and (if applicable) login_customer_id needed for every other Google Ads action.

Manager accounts (MCC)

If your Google account manages multiple client accounts through a Manager Account (MCC), listing your accounts will automatically detect this and return a login_customer_id alongside each sub-account's customer_id. When querying a sub-account, always pass both values along.

Using an MCC? When Claude runs an action on a sub-account, it needs the manager's customer ID as the login_customer_id. Listing your accounts first returns this automatically - Claude will handle the rest.

What access we request

We request the minimum Google Ads OAuth scopes needed - adwords read-only access. This allows reading campaign data, metrics, and search terms. We never request permission to create, modify, or delete any ads, campaigns, budgets, or account settings.

Connect Meta Ads

Meta Ads tools give Claude read-only access to your Facebook and Instagram ad accounts - including spend, ROAS, campaign performance, audience breakdowns, and creative analysis. Connection takes under a minute.

Meta Ads tools are completely free to use. You need an active Meta Ads account (Facebook Ads Manager) to connect. If your Facebook account has no ad accounts, the connection will not succeed.
1
Go to your dashboard

Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.

2
Click "Connect Meta Ads"

You will be redirected to Facebook's consent screen. We only request ads_read permission - read-only access to your ad performance data. We never request permission to create or modify your ads.

3
Return to Claude

After connecting, Meta Ads data is available immediately. Start by asking Claude to list your ad accounts to confirm the connection is working.

What access we request

We request only ads_read, which allows reading your ad performance data. We never request permission to create, edit, or delete any ads or campaigns. Your credentials are stored securely and never shared with third parties.

Revoking Meta Ads access

To disconnect, go to your dashboard and click Disconnect on the Meta Ads card. You can also revoke access directly from Facebook:

  1. Go to Facebook Settings → Apps and Websites
  2. Find Smacient-MCP-Servers and click Remove

Revoking Access

You are always in control of which accounts are connected. You can disconnect any connected account at any time directly from your dashboard.

How to disconnect a connected account

1
Go to your dashboard

Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.

2
Click "Disconnect" on the account you want to remove

The button will ask you to confirm - click it once more to proceed. This two-step process prevents accidental disconnects.

3
Access is removed immediately

Your stored credentials are deleted from our database right away. Claude will no longer be able to access that account's data.

What gets deleted? When you disconnect, we permanently delete the OAuth access token and refresh token stored for that service. We do not retain any copies. If you want to reconnect later, simply click "Connect" again - it takes under a minute.

Revoking access directly from Google

You can also revoke Google access independently of our dashboard - useful if you have lost access to your Smacient account.

  1. Go to myaccount.google.com/permissions
  2. Find Smacient-MCP-Servers in the list of connected apps
  3. Click on it and select Remove Access

Revoking from Google's side stops our tools from accessing your data immediately, but the stored tokens in our system will remain until you also disconnect from your dashboard or they naturally expire.

Available Tools

Once connected, Claude has access to 8 tools, each covering a focus area across 14 platforms. Every tool takes an action parameter selecting the specific operation, and a params object for that operation's inputs. Ask Claude to "describe" a tool if you want to see its exact operations and parameters yourself - Claude also does this automatically the first time it needs to.

Get Social Intelligence

Instagram, TikTok, YouTube, and LinkedIn - post performance, audience engagement, creator and company profiles, and search discovery.

Instagram - get posts from a profile, or search for profiles, hashtags, and places. Brand names are automatically resolved to the correct handle.

TikTok - get videos from a profile, or search videos by keyword with sort and date filters.

YouTube - get channel stats, recent videos, or top comments on a video.

LinkedIn - search for people, get a full profile or company page, get a single post's metadata, or fetch a person's recent posts.

Get Marketplace Intelligence

Amazon and Google Maps - product rankings, pricing, review sentiment, and business listing data.

Amazon - get customer reviews for specific products by ASIN or URL, or search by keyword/brand for ranked results with price, rating, and sales data.

Google Maps - search for businesses or places, or get reviews for a specific listing.

Get App Intelligence

Google Play and the Apple App Store - rankings, reviews, pricing, and competitive positioning.

Google Play - search by keyword, get reviews, get full app details, or find similar apps.

App Store - search by keyword, get full app details, or get reviews.

Get Ad Libraries

Public ad transparency data from Google and Meta - no account connection required, works for any brand.

Google Ads Library - find any brand's advertiser ID by name or domain, then fetch their public ad creatives, filterable by region, date, format, and active status.

Meta Ads Library - search any brand's active or historical Facebook/Instagram ads by name or page URL.

Query Web Performance

Requires Google account connection from your dashboard. Free to use.

Google Analytics 4 - list properties, run a custom report, get real-time active users, or compare two date periods.

Google Search Console - list sites, query search analytics, get top pages, compare periods, or find high-impression/low-CTR keyword opportunities.

Query Ad Performance

Requires Google Ads and/or Meta Ads account connection from your dashboard. Free to use.

Google Ads - list accounts, get an account overview, campaign performance, search terms with negative-keyword recommendations, video campaign metrics, Performance Max metrics, or run a custom GAQL query.

Meta Ads - list accounts, get an account summary, campaign performance, audience breakdown, placement performance, conversion funnel, creative-level performance, budget optimization recommendations, or a full campaign/ad set/ad structure overview.

Query Keyword Insights

Requires Google account connection from your dashboard.

Google Keyword Planner - get keyword ideas with search volume, competition, and CPC bid ranges from seed keywords or a URL, or get 24 months of historical search volume for specific keywords.

Get Account Status

Account - check your current credit balance, plan, and the full credit-cost reference. Free to call.

Credit Costs

Credits are deducted per action based on the volume of data returned. GA4, Search Console, Google Ads, and Meta Ads (your account) are always free. Asking a tool to describe its own operations is always free too - it never touches external data.

Tool / Action Credit Cost
Get Social Intelligence
Instagram - get posts1 per 2 posts returned
Instagram - search1 per 2 results returned
TikTok - get videos2 per video returned
TikTok - search2 per video returned
YouTube - channel info1 per channel
YouTube - videos2 per call
YouTube - comments2 per call
LinkedIn - search / profile / company / post / profile posts1 credit per call (5 posts per credit for profile posts)
Get Marketplace Intelligence
Amazon - get reviews1 per 10 reviews returned
Amazon - search1 per 50 results returned
Google Maps - search1 per call
Google Maps - get reviews1 per 10 reviews returned
Get App Intelligence
Google Play - search1 per 50 results returned
Google Play - reviews1 per 50 reviews returned
Google Play - app details1 per app returned
Google Play - similar apps1 per input app
App Store - search1 per 10 results returned
App Store - app details1 per app returned
App Store - reviews1 per 10 reviews returned
Get Ad Libraries (no account required)
Google Ads Library - find advertiserFree
Google Ads Library - get adsFree
Meta Ads Library - search ads1 (brand lookup, if used) + 1 per 10 ads returned
Query Keyword Insights
Keyword ideas5 credits per call
Historical keyword data10 credits per call
Query Ad Performance
All Google Ads and Meta Ads actionsFree
Query Web Performance
All GA4 and Search Console actionsFree
Get Account Status
Balance checkFree

Example Prompts

Just ask Claude naturally. Here are some examples to get you started:

"Get the last 10 posts from @nike and summarise what content themes are performing best."

"Search TikTok for 'skincare routine' videos and identify the top hooks being used."

"Get the latest 20 videos from the MrBeast YouTube channel and tell me which topics get the most views."

"Find coffee shops in Bangalore on Google Maps and pull their reviews - I want to know the most common complaints."

"Get the top 50 Amazon reviews for product B08C1W5N87 and tell me what customers love and what they keep complaining about."

"Search Google Play for 'expense tracker' apps in India and show me the top results with ratings and installs."

"Get the App Store reviews for com.instagram.android and tell me what users are complaining about most this month."

"Find apps similar to Swiggy on Google Play and give me a competitive overview."

"Show me the Meta ads that Coca-Cola has been running and analyse their messaging strategy."

"Find Tanishq on the Google Ads Library and show me what ad creatives they are running right now."

"Search for Nalli on the Google Ads Library - there may be multiple advertisers, show me the options first."

"Get keyword ideas for 'content marketing' in the United States and sort by search volume."

"Run a GA4 report showing sessions and users by page for the last 30 days."

"Compare my GA4 traffic for this month vs last month and highlight what has changed."

"Find my Search Console keywords with more than 500 impressions but less than 3% CTR - these are my quick win opportunities."

"List my Meta Ads accounts and show me overall spend and ROAS for the last 30 days."

"Break down my Meta Ads performance by age and gender - which demographic is converting best?"

"List my Google Ads accounts."

"Get my Google Ads campaign performance for the last month and tell me which campaigns have the best and worst ROAS."

"Pull my Google Ads search terms for the last 30 days and tell me which terms are spending with zero conversions."

"Show me my Performance Max campaign results and which ones I should scale or review."

Talk to your marketing data
Connect Claude free →

Contact Us