{"server_url":"https://api.duckdive.ai/mcp","tools":[{"name":"list_websites","title":"List websites","description":"List the websites you can access in DuckDive, with their connected data sources.","read_only":true,"input_schema":{"properties":{"search":{"default":"","description":"Optional text to match against website name or URL.","title":"Search","type":"string"},"limit":{"default":50,"description":"Maximum rows to return (1-100).","maximum":100,"minimum":1,"title":"Limit","type":"integer"},"offset":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},"title":"list_websitesArguments","type":"object"}},{"name":"get_website","title":"Get website","description":"Get one website's name, URL and connected data sources.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"}},"required":["website_id"],"title":"get_websiteArguments","type":"object"}},{"name":"get_sync_status","title":"Data sync status","description":"Show, per data source, whether the website's data is ready, importing or failing, and how recent it is.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"}},"required":["website_id"],"title":"get_sync_statusArguments","type":"object"}},{"name":"get_ga4_overview","title":"GA4 overview","description":"Google Analytics 4 sessions and conversions per day, with totals and conversion rate.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"time_range":{"default":"last30days","enum":["last7days","last14days","last30days","last90days","last6months","last12months"],"title":"Time Range","type":"string"}},"required":["website_id"],"title":"get_ga4_overviewArguments","type":"object"}},{"name":"get_ga4_channels","title":"GA4 channels","description":"GA4 sessions and conversions broken down by channel group (medium) or traffic source.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"time_range":{"default":"last30days","enum":["last7days","last14days","last30days","last90days","last6months","last12months"],"title":"Time Range","type":"string"},"group_by":{"default":"medium","enum":["medium","source"],"title":"Group By","type":"string"}},"required":["website_id"],"title":"get_ga4_channelsArguments","type":"object"}},{"name":"get_ga4_landing_pages","title":"GA4 landing pages","description":"Top GA4 landing pages by sessions, with conversions and conversion rate.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"time_range":{"default":"last30days","enum":["last7days","last14days","last30days","last90days","last6months","last12months"],"title":"Time Range","type":"string"},"limit":{"default":25,"description":"Maximum rows to return (1-100).","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["website_id"],"title":"get_ga4_landing_pagesArguments","type":"object"}},{"name":"get_search_console_summary","title":"Search Console summary","description":"Google Search Console clicks, impressions, CTR and average position over time.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"time_range":{"default":"last30days","enum":["last7days","last14days","last30days","last90days","last6months","last12months"],"title":"Time Range","type":"string"}},"required":["website_id"],"title":"get_search_console_summaryArguments","type":"object"}},{"name":"get_search_console_keywords","title":"Search Console keywords","description":"Top Google search queries for the website by clicks.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"time_range":{"default":"last30days","enum":["last7days","last14days","last30days","last90days","last6months","last12months"],"title":"Time Range","type":"string"},"limit":{"default":25,"description":"Maximum rows to return (1-100).","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["website_id"],"title":"get_search_console_keywordsArguments","type":"object"}},{"name":"get_search_console_pages","title":"Search Console pages","description":"Top pages in Google search results for the website by clicks.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"time_range":{"default":"last30days","enum":["last7days","last14days","last30days","last90days","last6months","last12months"],"title":"Time Range","type":"string"},"limit":{"default":25,"description":"Maximum rows to return (1-100).","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["website_id"],"title":"get_search_console_pagesArguments","type":"object"}},{"name":"get_google_ads_summary","title":"Google Ads summary","description":"Google Ads spend, clicks, impressions, conversions and cost per conversion for the website's account.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"time_range":{"default":"last30days","enum":["last7days","last14days","last30days","last90days","last6months","last12months"],"title":"Time Range","type":"string"}},"required":["website_id"],"title":"get_google_ads_summaryArguments","type":"object"}},{"name":"get_lsa_summary","title":"Local Services Ads summary","description":"Google Local Services Ads leads, charged leads and spend for the website's account.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"time_range":{"default":"last30days","enum":["last7days","last14days","last30days","last90days","last6months","last12months"],"title":"Time Range","type":"string"}},"required":["website_id"],"title":"get_lsa_summaryArguments","type":"object"}},{"name":"get_yext_summary","title":"Yext summary","description":"Yext listing status across publishers plus searches, views and actions over time.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"time_range":{"default":"last30days","enum":["last7days","last14days","last30days","last90days","last6months","last12months"],"title":"Time Range","type":"string"}},"required":["website_id"],"title":"get_yext_summaryArguments","type":"object"}},{"name":"get_yext_reviews","title":"Yext reviews","description":"Review counts and average rating for the website's Yext location, by publisher and star rating.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"}},"required":["website_id"],"title":"get_yext_reviewsArguments","type":"object"}},{"name":"get_local_rankings","title":"Local rankings","description":"Local Falcon map rankings: average rank and top-3 share per tracked keyword.","read_only":true,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"keyword":{"default":"","description":"Optional tracked keyword; when set, the latest ranking grid is included.","title":"Keyword","type":"string"}},"required":["website_id"],"title":"get_local_rankingsArguments","type":"object"}},{"name":"search","title":"Search","description":"Search your DuckDive websites by name or URL. Returns ids to use with fetch.","read_only":true,"input_schema":{"properties":{"query":{"maxLength":200,"minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"searchArguments","type":"object"}},{"name":"fetch","title":"Fetch","description":"Fetch a website returned by search: its URL and the status of each connected data source.","read_only":true,"input_schema":{"properties":{"id":{"maxLength":64,"minLength":1,"title":"Id","type":"string"}},"required":["id"],"title":"fetchArguments","type":"object"}},{"name":"get_setup_status","title":"Setup status","description":"Start here when the user is new, list_websites returns nothing, or the user asks to set up DuckDive.\n\nReturns the account (role, whether it can set things up, whether this connection may make changes), its\nclients, its websites with each data source's import status, whether Google is connected, suggested_websites\n(sites their Google account can see, when they have none yet), and next_step {code, message} saying exactly\nwhat to do next: add_website, connect_google, choose_sources, importing, ready or ask_admin. links holds pages\nto give the user (links.dashboard shows their data); links.connect_google, needed only when Google is not\nconnected, must be opened by the user in their own browser. Never ask for passwords or Google credentials.","read_only":true,"input_schema":{"properties":{},"title":"get_setup_statusArguments","type":"object"}},{"name":"list_available_sources","title":"List available data sources","description":"List the Google Analytics 4 properties, Search Console sites, Google Ads accounts and Local Services Ads\naccounts the user's connected Google logins can reach, to pick what connect_website_sources should link.\n\nPass website_id to mark items matching that website's domain as suggested (listed first) and get\nready_to_link: the one clear match per source that no other website uses, to link without asking. Ask the\nuser only about the rest. Items already used by a website show linked_website_id and linked_website_name.\nEmpty lists usually mean Google is not connected yet: give the user links.connect_google from\nget_setup_status.","read_only":true,"input_schema":{"properties":{"website_id":{"anyOf":[{"description":"DuckDive website id from list_websites or search.","minimum":1,"type":"integer"},{"type":"null"}],"default":null,"title":"Website Id"}},"title":"list_available_sourcesArguments","type":"object"}},{"name":"refresh_website_data","title":"Refresh website data","description":"Queue a re-import of recent data from Google and other sources. Admins only; once per website every 15 minutes.","read_only":false,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"source":{"anyOf":[{"enum":["ga4","gsc","google_ads","lsa","yext","local_falcon"],"type":"string"},{"type":"null"}],"default":null,"title":"Source"},"days":{"default":7,"description":"How many recent days to re-import (1-30).","maximum":30,"minimum":1,"title":"Days","type":"integer"}},"required":["website_id"],"title":"refresh_website_dataArguments","type":"object"}},{"name":"create_scheduled_report","title":"Create scheduled report","description":"Schedule a recurring DuckDive email report. It is always sent to your own account email. Admins only.","read_only":false,"input_schema":{"properties":{"website_ids":{"items":{"type":"integer"},"maxItems":50,"minItems":1,"title":"Website Ids","type":"array"},"frequency":{"enum":["daily","weekly","monthly"],"title":"Frequency","type":"string"},"data_sources":{"default":"all","enum":["all","ga4","gsc","google_ads","lsa","yext","heatmaps"],"title":"Data Sources","type":"string"},"time_range":{"default":"last30days","enum":["last7days","last10days","last30days","alltime"],"title":"Time Range","type":"string"}},"required":["website_ids","frequency"],"title":"create_scheduled_reportArguments","type":"object"}},{"name":"add_website","title":"Add website","description":"Add a website to DuckDive so its marketing data can be imported. Use it when get_setup_status says\nadd_website, with the address the user gives you. If the account has several clients the call fails and\nlists them: ask the user which one, then call again with client_id. Returns website_id and next_step.\nNothing is imported until connect_website_sources links its data sources. Admins only.","read_only":false,"input_schema":{"properties":{"url":{"description":"The website address, e.g. https://example.com.","maxLength":500,"title":"Url","type":"string"},"name":{"default":"","description":"Optional display name; defaults to the domain.","maxLength":200,"title":"Name","type":"string"},"client_id":{"anyOf":[{"description":"Client id from get_setup_status clients.","minimum":1,"type":"integer"},{"type":"null"}],"default":null,"title":"Client Id"}},"required":["url"],"title":"add_websiteArguments","type":"object"}},{"name":"connect_website_sources","title":"Connect website data sources","description":"Link a website to the GA4 property, Search Console site, Google Ads account and/or Local Services Ads\naccount from list_available_sources (its ready_to_link, or what the user picked) and start importing their\nhistory.\n\nA GA4 property or Search Console site belongs to one website at a time. If it is already linked to another\nwebsite the call fails and names it: ask the user, and only if they agree call again with\nmove_from_other_website=true. If the website already uses a different one, the call fails and names it: ask the\nuser, and only if they agree call again with replace_existing=true. Returns the website's import status; follow\nprogress with get_sync_status. Admins only.","read_only":false,"input_schema":{"properties":{"website_id":{"description":"DuckDive website id from list_websites or search.","minimum":1,"title":"Website Id","type":"integer"},"ga4_property_id":{"default":"","description":"GA4 property_id.","maxLength":64,"title":"Ga4 Property Id","type":"string"},"search_console_site_url":{"default":"","description":"Search Console site_url.","maxLength":500,"title":"Search Console Site Url","type":"string"},"google_ads_account_id":{"default":"","description":"Google Ads customer_id.","maxLength":64,"title":"Google Ads Account Id","type":"string"},"lsa_account_id":{"default":"","description":"Local Services Ads account_id.","maxLength":64,"title":"Lsa Account Id","type":"string"},"move_from_other_website":{"default":false,"description":"True only after the user agreed to move it from the website named in the error.","title":"Move From Other Website","type":"boolean"},"replace_existing":{"default":false,"description":"True only after the user agreed to replace the source this website already uses.","title":"Replace Existing","type":"boolean"}},"required":["website_id"],"title":"connect_website_sourcesArguments","type":"object"}}]}