How to add Builders HQ to Claude and other assistants, what each tool answers, how to connect your own accounts, the limits that apply, and what the common errors mean.
What it is
Builders HQ is one remote MCP server that answers AI assistants with numbers from Google Ads Keyword Planner, Microsoft Advertising, Google Search Console, Bing Webmaster Tools, IndexNow, YouTube, Google Maps, the App Store, Google Play, Cloudflare and Vercel. The tools are named by the question they answer; the vendor behind each answer is its source.
Server URL:https://buildershq.net/mcp
Transport: Streamable HTTP.
Authentication: OAuth 2.1 with PKCE. Every call needs a token from Builders HQ's own sign-in; you sign in with your Google account.
In Claude, open Settings › Connectors and choose Add custom connector.
Paste https://buildershq.net/mcp as the URL.
When Claude connects, it opens Builders HQ's sign-in. Sign in with Google and allow the assistant.
To use your own sites, channels or ad accounts, connect them on your Connections page (see Connect your accounts). Keyword, YouTube, places and app tools work without connecting anything.
Claude Code
claude mcp add --transport http buildershq https://buildershq.net/mcp
Grok: Plugins › New Connector › Custom, paste the URL; it asks you to sign in.
The assistant receives an access token that lasts one hour and a refresh token that lasts 30 days, replaced on every refresh. Your Assistants page lists every assistant signed in to your account; Disconnect deletes its tokens at once, and it asks you to sign in again next time.
Focused servers
An assistant reads the description of every tool a server offers at the start of each conversation. The full server has more than 30 tools; when you only need one job, add a focused server instead: the same account, sign-in, connections and limits, with only that job's tools and sources, so each chat starts with far fewer tokens and the assistant picks the right tool more often. Add its address exactly as you would the full one.
Address
For
Tools
https://buildershq.net/mcp/seo
Keyword research and your own sites on Google and Bing: search volumes and ideas, Search Console and Bing performance, URL inspection, sitemaps, IndexNow and inbound links.
Search volumes, keyword ideas, competition, bids and ad forecasts from Google Ads Keyword Planner and Microsoft Advertising, and Bing's organic keyword numbers.
Places on Google Maps: search, ratings, review counts, contacts, hours and reviews.
search_placesplace_detailsplace_reviews
A token from the full server also works on every focused one; a token from a focused server works only there. In Claude, the directory listing adds the full server; add a focused one with Add custom connector.
Data sources
Some vendors answer from Builders HQ's own credentials, so they work as soon as you sign in. The others read your own data and answer only from the account you connect; nobody else's connection is ever used for your questions.
Source
source id
Credentials
What you do
Google Ads Keyword Planner
google_ads
Builders HQ's
Nothing. Works right away.
Microsoft Advertising Keyword Planner
microsoft_ads
Builders HQ's
Nothing. Covers the US, GB, CA, AU, DE and FR only.
Which source answers. Every tool takes an optional source. Left out, the first source that is set up for you answers, in this order: google_ads, microsoft_ads, google_search_console, indexnow, bing_webmaster, google_maps, youtube, youtube_analytics, cloudflare, vercel, app_stores, meta_ads, bing_ads. So keyword tools default to Google Ads, the search tools to Search Console when it is connected (otherwise Bing), submit_urls to IndexNow (otherwise Bing), and the traffic tools to Cloudflare (otherwise Vercel). list_sources shows which are set up for you and what each answers.
Connect your accounts
Sign in at https://buildershq.net/account with Google, then open Connections (https://buildershq.net/account/connections). Each card below connects one vendor and has a Disconnect button. What you connect is kept encrypted in your own account; the page never shows a token or key back, and assistants see only the numbers the vendors return.
Google Search Console
Connect: press Connect Search Console. Google asks you to allow Search Console access for Builders HQ (scope https://www.googleapis.com/auth/webmasters). Leave every permission ticked: a partial grant is refused.
Checked: Builders HQ lists the properties the grant can see and shows how many were found.
Used for:search_performance, inspect_url, list_sites, get_site, the sitemap tools, and, only when you ask, add_site, remove_site, submit_sitemap and remove_sitemap.
Disconnect: press Disconnect on the card. The grant is deleted from your account; when no other Google connection (a YouTube channel) remains, it is also revoked with Google. You can remove the access yourself at myaccount.google.com/permissions.
Bing Webmaster Tools
Connect: press Connect Bing where the card offers it (a Microsoft sign-in for Bing Webmaster Tools, scope webmaster.manage), or paste an API key from Bing Webmaster Tools › Settings › API access › API Key.
Checked: a pasted key is tried with Bing first, by listing its sites; a key Bing refuses is not kept.
Used for: any search tool with source: "bing_webmaster", inbound_links, submit_urls with source: "bing_webmaster", and Bing's organic keyword numbers in keyword_volume and keyword_ideas.
Disconnect: press Disconnect; both the sign-in and any saved key are deleted.
IndexNow
Connect: type a site (for example example.com) and press Add a site. The card shows a file address, https://<site>/<key>.txt, and the key. Publish a file at that address whose whole text is the key, then press Check. Builders HQ fetches the file (from the site, and from its www address) and keeps the site once the file holds the key.
Limit: up to 50 sites per account.
Used for:submit_urls (the default source for it). A key is public by design: it proves the site is yours and nothing more.
Disconnect: press Remove next to a site.
YouTube Analytics
Connect: press Connect a YouTube channel. Google asks for read-only YouTube Analytics and YouTube access (scopes yt-analytics.readonly and youtube.readonly); pick the channel, or its brand account, on Google's page. Each channel is its own connection: press + Connect another channel for the next one.
Used for:youtube_analytics. With several channels connected, name one with channel. Public video and channel numbers (video_stats and the rest) need no connection.
Disconnect: press Disconnect next to a channel. It is deleted from your account, and revoked with Google when no other Google connection remains.
Cloudflare
Connect: open Cloudflare › API Tokens, press Create Token and use the Read analytics and logs template (all zones, or the ones to read). It grants Zone > Analytics > Read and Account > Account Analytics > Read. Paste the token on the card.
Checked: Cloudflare must accept the token and it must see at least one zone.
Used for:list_analytics_sites, site_traffic and traffic_breakdown with source: "cloudflare".
Disconnect: press Disconnect to delete the token from your account; you can also delete the token itself in Cloudflare.
Vercel Web Analytics
Connect: open vercel.com/account/settings/tokens, press Create and choose the scope (your team, or your personal account). Paste the token, with the team's slug if it is a team's (empty for a personal account).
Checked: Vercel must accept the token and list the team's projects.
Used for:list_analytics_sites, site_traffic and traffic_breakdown with source: "vercel", for projects with Web Analytics on.
Disconnect: press Disconnect to delete the token from your account; you can also delete the token itself in Vercel.
Microsoft Advertising (Bing Ads)
Connect: press Connect Microsoft Advertising and sign in with the Microsoft account you use at ads.microsoft.com. Microsoft asks for access to your advertising accounts (scope msads.manage, with offline access so the sign-in renews itself).
Checked: the sign-in must see at least one ad account.
Used for:list_ad_accounts, list_ad_campaigns and ad_performance with source: "bing_ads". These tools only read: nothing in your campaigns is created, changed, paused or deleted.
Availability: connecting Meta Ads is offered only when the Meta Ads card appears on your Connections page.
Connect: press Connect Meta Ads. Facebook asks you to allow Builders HQ to read your ads (ads_read). Meta lets a connection last about 60 days; the card says when to reconnect.
Used for: the three ad tools with source: "meta_ads", read-only.
The server publishes the tools below. Only submit_sitemap, remove_sitemap, add_site, remove_site and submit_urls change anything; they are marked as destructive, so your assistant asks before calling them. Every other tool only reads.
Every tool takes an optional source (see Data sources).
locations takes country codes ("US"; "UK" works), place names or ids from find_locations, up to 10; empty means worldwide. language defaults to "en".
A list parameter also takes one string ("a, b, c") or its singular name (keyword, query, url). Send everything in one call.
Unknown parameters are refused with a message naming the ones the tool takes. Search Console's own names (startDate, rowLimit, searchType, dimensionFilterGroups and others) are accepted.
Asking the same question again with different row filters costs no vendor call where the filters are applied to the cached answer: keyword_volume and keyword_ideas (min_volume, max_volume, contains, exclude, competition, sort, limit), ad_performance (sort, min_spend, limit) and list_ad_campaigns (limit).
Sources
Tool
What it answers
Key parameters
Source
Effect
list_sources
Which vendors this server has, whether each is set up or connected for you, and which questions each answers.
none
none (answers from the server itself)
Reads
Keyword research
Tool
What it answers
Key parameters
Source
Effect
keyword_volume
Average monthly searches, competition and the top-of-page bid range for keywords you already have.
keywords (up to 1,000; 50 on Bing), locations, language, network, months, filters (min_volume, contains, exclude, competition), sort, limit
google_ads, microsoft_ads, bing_webmaster
Reads
keyword_ideas
Related keywords, with their numbers, from seed keywords, a page URL, or a whole site.
seeds (up to 20), url, site (on its own), locations, language, filters, limit (default 50, up to 1,000)
Expected clicks, average CPC, cost and conversions for bidding on a set of keywords as one ad group. Nothing is created or spent: it is the planner's forecast.
keywords (up to 200), match (broad, phrase, exact), max_cpc, daily_budget, days (1-365), locations, language
google_ads, microsoft_ads
Reads
find_locations
The ids the other tools take in locations, for countries, regions, cities and postcodes, when a plain name is ambiguous.
names (up to 25), country, limit
google_ads, microsoft_ads
Reads
Your sites on Google Search Console and Bing
Tool
What it answers
Key parameters
Source
Effect
search_performance
Clicks, impressions, CTR and average position, in total and broken down. Google: by query, page, country, device, date, search appearance or hour, for web, image, video, news, Discover or Google News, with filters and a comparison period. Bing: by query, page and date, web only.
site, range or start_date/end_date, dimensions, type, filters, compare, data_state, max_rows (default 1,000, up to 100,000), start_row
google_search_console, bing_webmaster
Reads
inspect_url
What the search engine knows about URLs of your site. Google: indexed or not and why, last crawl, Google's chosen canonical, robots.txt and fetch state, sitemaps listing it, mobile usability, rich results. Bing: HTTP status, when found and last crawled, size, links to it.
urls (up to 20), site, language
google_search_console, bing_webmaster
Reads
list_sites
Every site on the connected account, with its permission level or verification.
none
google_search_console, bing_webmaster
Reads
get_site
One site and the account's permission on it.
site
google_search_console, bing_webmaster
Reads
list_sitemaps
The sitemaps submitted for a site: URLs submitted and indexed, last download, errors and warnings.
site, sitemap_index
google_search_console, bing_webmaster
Reads
get_sitemap
One submitted sitemap: what it holds, how much is indexed, its errors and warnings.
site, sitemap
google_search_console, bing_webmaster
Reads
list_sitemap_urls
The page URLs inside a site's sitemaps, with each one's lastmod, read from the sitemap files Search Console lists for the site (or the one named). Sitemap indexes and .gz files are followed; only files on the site's own host are read.
site, sitemap, contains, max_urls (default 1,000, up to 50,000)
google_search_console
Reads
submit_sitemap
Submits (or resubmits) a sitemap URL for a site, so the search engine reads it again.
site, sitemap
google_search_console, bing_webmaster
Changes your account
remove_sitemap
Removes a submitted sitemap from a site.
site, sitemap
google_search_console, bing_webmaster
Changes your account
add_site
Adds a site (Google: "sc-domain:example.com" or "https://example.com/"; Bing: "https://example.com/"). It stays unverified until you verify it with Google or Bing.
site
google_search_console, bing_webmaster
Changes your account
remove_site
Removes a site from the account.
site
google_search_console, bing_webmaster
Changes your account
Indexing and links
Tool
What it answers
Key parameters
Source
Effect
submit_urls
Tells search engines that pages were added, changed or deleted, so they crawl them. IndexNow reaches Bing, Yandex, Seznam and Naver; Bing Webmaster Tools submits within its daily quota. With check: true it sends nothing and says whether each host is ready.
urls (up to 10,000, one host or several), check
indexnow, bing_webmaster
Sends URLs to the search engines (nothing with check: true)
inbound_links
Links from other sites to yours as Bing found them: your pages with the most inbound links, or, with url, the pages linking to one URL and their anchor text.
site, url, page
bing_webmaster
Reads
Places
Tool
What it answers
Key parameters
Source
Effect
search_places
Looks up public places on Google Maps for a search: name, rating, review count, categories, address, phone, website, opening hours, coordinates and place id.
queries (up to 5; put the area in each), near (a point and radius), limit (up to 20 per query)
google_maps
Reads
place_details
One place's public details in full: rating, review count, categories, address, phone, website, opening hours, coordinates, place id and Maps link.
places (up to 10: a name and town, a Maps link or a place id)
google_maps
Reads
place_reviews
Public reviews of a place: stars, text, when and who. Up to 5 per place, Google's choice of the most relevant.
places (up to 5), language
google_maps
Reads
YouTube
Tool
What it answers
Key parameters
Source
Effect
video_stats
Public numbers for any videos: views, likes, comments, views per day, length, publish date, tags, language and description.
videos (URLs or ids, up to 200), full_description
youtube
Reads
channel_stats
Public numbers for any channels: subscribers (rounded by YouTube), total views, video count, country, creation date, handle and description.
channels (@handles, URLs or ids, up to 50), full_description
youtube
Reads
channel_videos
A channel's most recent uploads with each video's public numbers.
channels (up to 10), max (default 50, up to 500), published_after, sort
youtube
Reads
search_videos
Searches YouTube and returns each result with its public numbers.
queries (up to 5), max (up to 50), order, region, language, channel_id, published_after/published_before, duration
youtube
Reads
video_comments
A video's top-level comments with likes and reply counts.
videos (up to 10), max (up to 100), order, search
youtube
Reads
youtube_analytics
Your own connected channels' YouTube Analytics. Reports: overview, daily, videos, traffic_sources, search_terms, countries, devices.
report, channel (needed when several are connected), video, range or start_date/end_date, limit
youtube_analytics
Reads
Site traffic
Tool
What it answers
Key parameters
Source
Effect
list_analytics_sites
The sites a web-analytics source can report on: every Cloudflare zone the token reads, or every Vercel project with its domains.
none
cloudflare, vercel
Reads
site_traffic
A site's traffic over a period, in total and day by day. Vercel: visitors and page views. Cloudflare: Web Analytics visits and page views where the beacon is on, plus every request at the edge (requests, page views, unique IPs, bandwidth, cache share, threats).
site, range or start_date/end_date, filter (Vercel only)
cloudflare, vercel
Reads
traffic_breakdown
A site's top values of one dimension over a period. Cloudflare: path, country, referrer, device, browser, os, host, status. Vercel: path, country, referrer, device, browser, os, route, utm_source, utm_medium, utm_campaign.
site, by, measure (visitors, or requests on Cloudflare), range or dates, limit, filter (Vercel only)
cloudflare, vercel
Reads
Your ad accounts
Tool
What it answers
Key parameters
Source
Effect
list_ad_accounts
Your own ad accounts: id, name, currency, time zone and status, and Microsoft's account number and pause reason.
none
bing_ads (and meta_ads where it is offered)
Reads
list_ad_campaigns
The campaigns, ad groups, ads or keywords in one of your ad accounts, with status, budgets, bids, each ad's creative and each keyword's match type and bid.
How your ads did: spend, impressions, clicks, CTR, CPC, CPM, conversions, conversion rate, cost per conversion, revenue and ROAS, per account, campaign, ad group, ad, keyword (with quality score) or search term, in total or by day, week or month, optionally by age, gender, country, region, device or network.
account, level, range or start_date/end_date, time_increment, breakdown, campaign_ids, adset_ids, ad_ids, sort, min_spend, limit
bing_ads (and meta_ads where it is offered)
Reads
Apps
Tool
What it answers
Key parameters
Source
Effect
search_apps
Apps on Apple's App Store and Google Play for a search, as each store ranks them: name, developer, rating, installs (Play) or rating count (App Store), category, store id and link.
queries (up to 10), stores, country, limit (up to 50 per store)
app_stores
Reads
check_app_name
Whether an app name is free to use: a level (taken, avoid, used, crowded, similar or free) with the apps behind it, whether the likely Android package ids are published, and whether its domains are registered. Live apps only.
of which keyword planner calls (keyword_volume, keyword_ideas, keyword_forecast)
50
of which Google Maps calls (search_places, place_details, place_reviews)
100
Only a call that reaches a vendor counts. An answer from the cache is free, and so is list_sources. A change (submitting a sitemap or URLs, adding or removing a site) always reaches the vendor and always counts.
A tool that takes a list answered item by item (inspect_url, search_places, place_details, place_reviews, channel_videos, search_videos, video_comments, search_apps) counts one call per item not already cached. keyword_volume with 1,000 keywords is one call.
The counts start again at midnight UTC. Your Overview page shows today's use.
Size of one call
Tool
Most per call
keyword_volume
1,000 keywords (Google Ads, Microsoft Advertising); 50 on Bing Webmaster Tools
keyword_ideas
20 seeds; up to 1,000 ideas back
keyword_forecast
200 keywords; 1-365 days
find_locations
25 names, 10 matches each
search_performance
100,000 rows (default 1,000)
inspect_url
20 URLs
list_sitemap_urls
50,000 URLs (default 1,000); up to 50 sitemap files read
submit_urls
10,000 URLs
search_places
5 queries, 20 places each
place_details / place_reviews
10 places / 5 places, 5 reviews each
video_stats / channel_stats
200 videos / 50 channels
channel_videos
10 channels, 500 uploads each
search_videos / video_comments
5 searches of up to 50 results / 10 videos of up to 100 comments
traffic_breakdown
100 rows
list_ad_campaigns / ad_performance
5,000 rows read
search_apps / check_app_name
10 queries, 50 apps per store / 10 names, 6 domains
Vendor quotas and data ranges
Google Search Console: data goes back 16 months and final data lags about two days; hourly data needs data_state: "hourly_all" and covers the last few days. URL inspection is limited by Google to 2,000 a day and 600 a minute per property.
Bing Webmaster Tools: about six months of search data, queries and pages in weekly rows, web search only. URL submission has a daily quota per site; submit_urls says how many are left.
IndexNow: no quota; up to 10,000 URLs per call; repeated submissions of an unchanged URL are ignored. Bing decides when to crawl, usually within hours.
YouTube Data API: Builders HQ's project has 10,000 quota units a day, shared. A search costs 100 units; video and channel lookups cost 1 unit per 50 videos or per channel.
YouTube Analytics: numbers settle 2-3 days late; the period ends two days ago unless end_date says otherwise. search_terms lists at most the top 25.
Microsoft Advertising Keyword Planner: the US, GB, CA, AU, DE and FR only, languages en, fr and de.
Google Ads Keyword Planner: monthly averages over the last 12 months unless months says otherwise; at most 10 locations a call.
Cloudflare: Web Analytics visitors cover at most 91 days; a requests breakdown at most 30 days; edge requests in site_traffic up to 366 days.
App Store: its search allows about 20 searches a minute.
Google Maps: reviews come from the Google Places API, up to 5 per place, Google's own selection.
Caching
Answers are kept in the server's memory so the same question does not call the vendor twice. An answer from one of your own connected accounts is cached for your account only. The cache can start empty at any time (a new server instance), so these are the longest an answer is reused:
Each answer says cached: true when it came from the cache.
Common errors
A tool that cannot answer returns an error result with one readable line, never a stack trace or a credential. These are the messages you are most likely to see; <...> marks the part that varies.
General
Message
What to do
<Source> is not connected to your account: connect it at https://buildershq.net/account.
You named a source that reads your own data and it is not connected. Connect it on your Connections page.
No source is connected for <question>: connect <sources> at https://buildershq.net/account.
None of the sources that answer this tool is connected. Connect one of the sources named.
No source "<id>". Sources: <ids>.
The source value is misspelled. Use one of the ids listed, or ask list_sources.
<Source> cannot answer <question>. Sources that can: <ids>.
That vendor does not answer this tool. Use one of the ids listed, or leave source out.
<tool> has no parameter "<name>". It takes: <parameters>.
Unknown parameters are refused rather than ignored. Rename or drop the parameter; the message lists the ones the tool takes.
Your account has used today's 300 calls (the free beta's daily limit). It starts again at midnight UTC; answers already asked today still come from the cache.
The daily limit is reached (the same message names 50 keyword planner calls or 100 Google Maps calls when it is one of those). Wait for midnight UTC, or repeat questions already asked today, which are answered from the cache for free.
The server had a problem answering. Try again in a minute.
An unexpected error on Builders HQ's side. Try again; if it repeats, write to support@buildershq.net.
<Source> is not set up on this server (<names> missing).
A vendor that answers from Builders HQ's own credentials is not configured. Nothing on your side fixes it: write to support@buildershq.net.
<message> (Worth trying again.)
A temporary vendor problem (a timeout, a server error, a rate limit). Ask again in a minute.
Keyword research
Message
What to do
Google Ads is rate-limiting the planner (<code>): wait a minute and ask again.
Wait a minute. Send all keywords in one call rather than one call per keyword.
No Google location matches "<name>". find_locations lists what a name can mean.
Run find_locations and pass the id it returns, or a two-letter country code.
Google's planner takes at most 10 locations at once.
Split the locations across calls.
Google has no language "<x>". Use a code such as en, uk, de, a name, or "all".
Pass a language code, a language name, or "all".
site cannot be combined with seeds or url: Google takes a whole site on its own.
Send site alone, or seeds and/or url without it.
Microsoft's keyword planner has no numbers for <country>: it answers for US, GB, CA, AU, DE, FR and places inside them ...
Use google_ads for other countries.
Microsoft's keyword planner takes English, French or German (en, fr, de), not "<x>". ...
Pass en, fr or de.
Bing is asked one keyword at a time: give at most 50.
With source: "bing_webmaster", send at most 50 keywords.
Bing keyword research takes one country at a time.
Pass a single two-letter country code in locations.
Bing finds ideas from seed keywords only: give seeds, not url or site.
Send seeds only.
Search Console and Bing Webmaster Tools
Message
What to do
This account has no Search Console property for "<site>". It has: <properties>.
Use one of the properties listed (list_sites shows them), or connect the Google account that owns the property.
Search Console has no sitemap for <site>. Submit one first (submit_sitemap), or name it with sitemap.
Submit a sitemap, or pass sitemap to list_sitemap_urls.
None of these sitemaps is on the site, so none was read: <urls>.
list_sitemap_urls reads only sitemap files on the site's own host. Name a sitemap on that host.
Search Console quota or rate limit reached (<reason>): <Google's message>
Google's own quota (URL inspection allows 2,000 a day and 600 a minute per property). Wait and ask again, with fewer URLs.
Google sign-in for Search Console failed (<status> <error>).
The Google grant no longer works (revoked or expired). Press Reconnect on the Search Console card on your Connections page.
Bing Webmaster Tools is not connected: open /account on this server and press "Connect Bing".
Connect Bing, or paste a Bing API key, on your Connections page.
The Bing connection was revoked or has expired: open /account and connect Bing again.
Connect Bing again on your Connections page.
This Bing account has no site "<site>". It has: <sites>.
Use one of the sites listed, or add it to Bing Webmaster Tools first.
Bing gives queries and pages together only for one page or one query: add a filter page equals <url>, or query equals <query>.
Add the filter the message names, or ask for query and page separately.
Bing breaks performance down only by query, page, date; not by <dimension>.
Use only those dimensions with Bing.
<site> has <n> URL submissions left today on Bing, fewer than the <m> given. Use source "indexnow" (no quota) or send fewer.
Send fewer URLs, or submit through IndexNow.
IndexNow
Message
What to do
IndexNow has no key for <host>. Hosts with a key: <hosts>. ...
Add the site under IndexNow on your Connections page and put its key file in place, or send source: "bing_webmaster".
https://<host>/<key>.txt does not hold the key yet. Put a file there whose whole text is <key>, then check again.
Shown on the Connections page when you press Check. Publish the file at that address with exactly the key as its text, then press Check again.
Places, YouTube and apps
Message
What to do
Google Maps found no place for "<name>". Add the town, or pass a Maps link.
Add the town to the name, or pass a Google Maps link or a place id.
Google Places refused it: <message>
Google's Places API refused the request. The message says why; try again later if it is a quota.
No channel found for "<channel>".
Check the @handle, channel URL or id.
YouTube quota or rate limit reached (<reason>): <message>
The shared YouTube quota is spent for now. search_videos is the costly call: search once, then filter.
<n> channels are connected: say which with channel (<channels>).
Pass channel with the channel's @handle, title or id.
No connected channel "<channel>". Connected: <channels>. Connect another on the account page.
Use a connected channel, or connect this one on your Connections page.
The App Store search is asking this server to slow down (about 20 searches a minute). Try again in a minute.
Wait a minute and ask again, with all queries in one call.
Google Play is asking this server to slow down. Try again in a few minutes.
Wait a few minutes and ask again.
Site traffic
Message
What to do
No Cloudflare zone this token can read covers "<site>". list_analytics_sites shows them.
Use a zone the token reads, or create a token that covers this zone and paste it again.
Visitors cover at most 91 days.
Ask for a shorter period.
A requests breakdown spans at most 30 days on Cloudflare.
Ask for 30 days or fewer.
No Vercel project on this team serves "<site>". list_analytics_sites shows them.
Use a project or domain listed, or reconnect Vercel with a token scoped to the team that owns it.
Vercel Web Analytics counts visitors and page views, not requests. Leave measure out.
Leave measure out for Vercel.
Your ad accounts
Message
What to do
<n> ad accounts: say which with account (<accounts>).
Pass account with the id, number or name.
No Microsoft Advertising account "<account>" for this sign-in. It sees: <accounts>.
Use one of the accounts listed.
Microsoft is still building this report. It keeps going: ask the same question again in a minute and the finished report is picked up.
Ask the same question again in a minute.
Microsoft could not build this report (its status is Error). Try again, or ask for a shorter period.
Try again, or a shorter period.
The Microsoft Advertising sign-in has expired or was revoked: connect it again at /account/connections.
Press Reconnect on the Microsoft Advertising card.
The Meta Ads connection has expired (Meta lets one last about 60 days): connect it again at /account/connections.
Press Reconnect on the Meta Ads card.
Connecting an account (shown on the Connections page)
Message
What to do
Google did not give every access asked for: tick each box on Google's page and connect again.
Connect again and leave every permission on Google's consent screen ticked.
That Google account has no YouTube channel. Connect again and pick the channel (a brand account is listed separately).
Connect again and choose the channel, or its brand account, on Google's page.
That token sees no zones: give it Zone > Analytics > Read for the zones to read.
Create the Cloudflare token from the "Read analytics and logs" template.
That token has no team "<team>". It has: <teams>.
Use one of the team slugs listed, or leave the team empty for a personal account.
That Microsoft account has no Microsoft Advertising accounts. Sign in with the one you use at ads.microsoft.com.
Sign in with the Microsoft account you use for Microsoft Advertising.
That Facebook account has no ad accounts it can read. Sign in with the one you use in Ads Manager.
Sign in with the Facebook account you use in Ads Manager.
Data handling
Your account: your email address, name and Google profile picture, from Google's sign-in.
What you connect: each grant, token or key, with the names of the sites, channels and ad accounts it covers. Every value is encrypted at rest with AES-256-GCM; in production the encryption keys are themselves wrapped by a master key held in Azure Key Vault and is never shown back to you or to any assistant.
Assistants: which assistant you allowed and when. Its tokens are stored only as SHA-256 hashes.
Usage: how many vendor calls your account made each day, for the daily limits, kept 40 days.
Activity: for each tool call, the tool, its arguments (fields named like a key, token, secret or password are left out), which assistant asked, whether it worked and how long it took, kept 90 days. The answers are not kept in it.
Answers: cached in memory as described under Caching, never written to the database.
Removing it: disconnecting a service deletes its credentials at once. To delete your account and everything kept for it, write to support@buildershq.net.