Marketing Data & Context for Claude
How to connect and start pulling live marketing data directly into Claude.
Marketing Data & Context for Claude connects as an MCP (Model Context Protocol) server. Once connected, Claude can pull live data from Instagram, TikTok, YouTube, Google Maps, Meta Ads Library, Meta Ads (your account), Google Ads (your account), Google Keyword Planner, Google Analytics 4, and Google Search Console on demand - no copy-pasting, no exports.
Click here to sign up - you get 30 free credits instantly, no credit card required.
Follow the instructions below.
Just describe what you need in plain English - Claude handles the rest.
Connect via Claude.ai (Pro and Team plans) - once connected, it also works automatically in Claude Code and Claude Desktop.
Smacienthttps://claude.smacient.com/mcpnpm install -g @smacient/mcp && smacient-mcp setupclaude "List my GA4 properties"
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.
Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.
You'll be redirected to Google's consent screen. Each tool requires its own connection - GA4 and Search Console share a single Google OAuth connection, so connecting once gives you access to both.
After connecting, the tools become available immediately. Ask Claude to list your properties to confirm the connection is working.
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 completely free to use.
Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.
You'll 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.
gads_list_accounts
Always start by asking Claude to list your Google Ads accounts. This returns the customer_id and (if applicable) login_customer_id needed for all other Google Ads tools.
If your Google account manages multiple client accounts through a Manager Account (MCC), gads_list_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 to the tool.
login_customer_id. The gads_list_accounts tool returns this automatically - just ask Claude to list your accounts first and it will handle the rest.
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.
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.
Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.
You'll be redirected to Facebook's consent screen. Grant read-only access to your ad data - we only request ads_read permission. We never request permission to create or modify your ads.
After connecting, all Meta Ads tools are available immediately. Start by asking Claude to list your ad accounts to confirm the connection is working.
We request the minimum permissions needed - only ads_read, which allows reading your ad performance data. We never request permission to create, edit, or delete any ads or campaigns. Your ad account credentials are stored securely and never shared with third parties.
To disconnect, go to your dashboard and click Disconnect on the Meta Ads card. You can also revoke access directly from Facebook:
You are always in control of which accounts are connected. You can disconnect any connected account at any time directly from your dashboard.
Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.
The button will ask you to confirm - click it once more to proceed. This two-step process prevents accidental disconnects.
Your stored credentials are deleted from our database right away. Claude will no longer be able to access that account's data.
You can also revoke Google access independently of our dashboard - useful if you've lost access to your Smacient account.
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.
Once connected, Claude has access to 37 tools across 10 platforms:
extract_instagram_posts
Extract recent posts from one or more Instagram profiles by exact username. Returns captions, likes, comments, video URLs, carousel images, and timestamps. Use this when you already know the username.
search_instagram
Search Instagram to discover profiles, hashtags, or places. Returns account metadata (follower counts, bios) - not post content. Use this to find a username, then use extract_instagram_posts to get their posts.
extract_tiktok_videos
Extract recent videos from a TikTok profile. Returns views, likes, shares, comments, and captions.
search_tiktok
Search TikTok by keyword and return matching videos with engagement data.
get_youtube_channel
Get channel stats: subscribers, total views, video count, and description. Accepts channel handle, URL, or ID.
get_youtube_videos
Get recent videos from a channel with views, likes, comments, and duration. Optionally include or exclude Shorts.
get_youtube_comments
Fetch top comments from a YouTube video. Sort by relevance or newest. Useful for audience sentiment and feedback analysis.
search_google_maps
Search for businesses or places by name, optionally filtered by city. Returns ratings, addresses, and a data_id to pass to the reviews tool.
extract_google_maps_reviews
Extract reviews for a specific Google Maps listing using a data_id from the search tool or a Maps URL.
search_meta_ads
Search the Meta Ads Library for a brand's active or historical ads. Returns ad copy, creative details, and run dates. No account connection required — works for any brand.
meta_list_accounts
List all Meta Ads accounts your connected Facebook account has access to. Returns account IDs, names, currency, status, and total spend. Always run this first to find the account ID needed for other Meta Ads tools.
meta_get_account_summary
Get overall performance for a date range - total spend, ROAS, CTR, CPC, CPM, reach, purchases, and revenue.
meta_analyze_campaigns
Campaign-level performance breakdown sorted by spend. Includes ROAS per campaign and recommendations on which to scale or pause.
meta_audience_breakdown
Break down ad performance by age, gender, country, device, or publisher platform.
meta_placement_performance
Compare performance across Facebook Feed, Instagram Feed, Reels, Stories, Audience Network, and Messenger placements.
meta_conversion_funnel
Analyse the full funnel from impressions → clicks → view content → add to cart → purchases. Shows drop-off rates at each stage.
meta_creative_analysis
Ad-level performance to identify winning creatives - CTR, ROAS, and purchases per individual ad.
meta_budget_optimization
Categorises campaigns into: scale up (ROAS > 3), maintain (ROAS 1.5–3), reduce (ROAS < 1.5), or pause (zero conversions).
gads_list_accounts first to get the customer_id and login_customer_id needed for other tools.
gads_list_accounts
List all Google Ads accounts your connected Google account has access to. Returns account IDs, names, currency, timezone, and status. For Manager (MCC) accounts, also returns the login_customer_id needed to query sub-accounts. Always run this first.
gads_get_account_overview
Get overall account performance - total spend, clicks, impressions, conversions, ROAS, average CPC, and cost per conversion for a date range.
gads_get_campaign_performance
Campaign-level performance breakdown sorted by spend - spend, clicks, impressions, conversions, ROAS, and cost per conversion per campaign.
gads_get_search_terms
Analyse search queries that triggered your ads. Returns performance per search term and automatically flags high performers to add as keywords and wasted spend terms to add as negatives.
gads_get_video_campaigns
Get performance for YouTube and video campaigns - views, view rate, cost per view, and completion rates (25%, 50%, 75%, 100% quartiles).
gads_get_pmax_performance
Get metrics for Performance Max campaigns - spend, conversions, ROAS, and recommendations on which PMax campaigns to scale or review.
gads_run_gaql_query
Execute a custom GAQL (Google Ads Query Language) SELECT query for advanced analysis not covered by the other tools. Read-only - write operations are blocked.
get_keyword_ideas
Generate keyword ideas from a seed keyword or URL. Returns search volume, competition level, and bid range estimates for each keyword.
get_historical_keyword_data
Fetch up to 24 months of monthly search volume history for one or more keywords. Useful for spotting seasonal trends and long-term demand shifts.
ga4_list_properties
List all GA4 accounts and properties connected to your Google account. Use this to find the property ID needed for other GA4 tools.
ga4_get_report
Run a custom GA4 report for any property. Specify dimensions (e.g. page, country, device), metrics (e.g. sessions, users, conversions), and a date range.
ga4_get_realtime
Get real-time active users and top pages or sources for a GA4 property right now.
ga4_compare_periods
Compare two date periods side by side for any GA4 property. Returns metrics for both periods with absolute and percentage change.
gsc_list_sites
List all verified sites in your Google Search Console account.
gsc_query_analytics
Query search analytics for a site. Returns clicks, impressions, CTR, and average position for any date range and dimension (query, page, country, device).
gsc_top_pages
Get the top performing pages from Search Console ranked by clicks for a given date range.
gsc_compare_periods
Compare two time periods of organic search performance. Useful for spotting traffic shifts after content updates or algorithm changes.
gsc_find_opportunities
Find keywords with high impressions but low CTR - pages that rank but don't get clicks. Filter by minimum impressions and maximum CTR thresholds.
get_credits_balance
Check your current credit balance and plan. Free to call.
Credits are deducted per tool call based on the volume of data returned. GA4, Search Console, Google Ads, and Meta Ads (your account) tools are always free.
| Tool | Credit Cost |
|---|---|
| Social & Web | |
extract_instagram_posts | 1 per 3 posts returned |
search_instagram | 1 per 3 results returned |
extract_tiktok_videos | 2 per video returned |
search_tiktok | 2 per video returned |
get_youtube_channel | 1 per channel |
get_youtube_videos | 2–3 per call (tiered by count) |
get_youtube_comments | 2–3 per call (tiered by count) |
search_google_maps | 1 per call |
extract_google_maps_reviews | 1 per 30 reviews returned |
search_meta_ads | 1 (brand lookup) + 1 per 10 ads |
| Keyword Research | |
get_keyword_ideas | 5 credits per search |
get_historical_keyword_data | 10 credits per call |
| Google Ads - Your Account | |
gads_list_accounts | Free |
gads_get_account_overview | Free |
gads_get_campaign_performance | Free |
gads_get_search_terms | Free |
gads_get_video_campaigns | Free |
gads_get_pmax_performance | Free |
gads_run_gaql_query | Free |
| Meta Ads - Your Account | |
meta_list_accounts | Free |
meta_get_account_summary | Free |
meta_analyze_campaigns | Free |
meta_audience_breakdown | Free |
meta_placement_performance | Free |
meta_conversion_funnel | Free |
meta_creative_analysis | Free |
meta_budget_optimization | Free |
| Google Analytics 4 | |
ga4_list_properties | Free |
ga4_get_report | Free |
ga4_get_realtime | Free |
ga4_compare_periods | Free |
| Google Search Console | |
gsc_list_sites | Free |
gsc_query_analytics | Free |
gsc_top_pages | Free |
gsc_compare_periods | Free |
gsc_find_opportunities | Free |
| Account | |
get_credits_balance | Free |
Just ask Claude naturally. Here are some examples to get you started:
"Extract 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 New York on Google Maps and pull their reviews - I want to know the most common complaints."
"Show me the Meta ads that Coca-Cola has been running and analyse their messaging strategy."
"Get keyword ideas for 'content marketing' in the United States and sort by search volume."
"List my GA4 properties so I can find my property ID."
"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's changed."
"List my Search Console sites and show me the top 20 pages by clicks for the last 28 days."
"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."
"Analyse my Meta Ads campaigns for the last month - which ones should I scale and which should I pause?"
"Break down my Meta Ads performance by age and gender - which demographic is converting best?"
"Show me my Meta Ads conversion funnel for last month - where am I losing the most potential customers?"
"List my Google Ads accounts."
"Show me my Google Ads account overview for the last 30 days - total spend, ROAS, and cost per conversion."
"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 report for the last 30 days and tell me which terms are wasting budget with zero conversions."
"Show me my Performance Max campaign results and which ones I should scale or review."
"Compare my Google Ads spend and conversions week over week for the last two weeks."