Documentation

Builders HQ connector

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.

Add it to your assistant

Claude

  1. In Claude, open Settings › Connectors and choose Add custom connector.
  2. Paste https://buildershq.net/mcp as the URL.
  3. When Claude connects, it opens Builders HQ's sign-in. Sign in with Google and allow the assistant.
  4. 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

The first call opens the same sign-in.

Other assistants

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.

AddressForTools
https://buildershq.net/mcp/seoKeyword 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.list_sources keyword_volume keyword_ideas find_locations search_performance inspect_url list_sites list_sitemaps list_sitemap_urls submit_sitemap submit_urls inbound_links
https://buildershq.net/mcp/google-search-consoleYour sites on Google Search Console: performance by query, page, country, device and date, URL inspection, sitemaps and properties.search_performance inspect_url list_sites get_site list_sitemaps get_sitemap list_sitemap_urls submit_sitemap remove_sitemap add_site remove_site
https://buildershq.net/mcp/keyword-researchSearch volumes, keyword ideas, competition, bids and ad forecasts from Google Ads Keyword Planner and Microsoft Advertising, and Bing's organic keyword numbers.keyword_volume keyword_ideas keyword_forecast find_locations
https://buildershq.net/mcp/bing-webmaster-toolsYour sites on Bing: performance, inbound links, sitemaps, Bing's keyword numbers, and IndexNow submission.search_performance list_sites list_sitemaps submit_sitemap submit_urls inbound_links keyword_volume keyword_ideas
https://buildershq.net/mcp/youtubePublic numbers for any YouTube video or channel, YouTube search, comments, and your own channels' YouTube Analytics.video_stats channel_stats channel_videos search_videos video_comments youtube_analytics
https://buildershq.net/mcp/google-mapsPlaces on Google Maps: search, ratings, review counts, contacts, hours and reviews.search_places place_details place_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.

Sourcesource idCredentialsWhat you do
Google Ads Keyword Plannergoogle_adsBuilders HQ'sNothing. Works right away.
Microsoft Advertising Keyword Plannermicrosoft_adsBuilders HQ'sNothing. Covers the US, GB, CA, AU, DE and FR only.
YouTube Data API (public numbers)youtubeBuilders HQ'sNothing. Works right away.
Google Maps (Google Places API)google_mapsBuilders HQ'sNothing.
App Store and Google Playapp_storesnone: public store searchNothing. Works right away.
Google Search Consolegoogle_search_consoleyoursConnect Search Console
Bing Webmaster Toolsbing_webmasteryoursConnect Bing or paste an API key
IndexNowindexnowyours (a key file on each site)Add each site and its key file
YouTube Analyticsyoutube_analyticsyoursConnect each channel
CloudflarecloudflareyoursPaste an API token
Vercel Web AnalyticsvercelyoursPaste an access token
Microsoft Advertising (Bing Ads)bing_adsyoursConnect Microsoft Advertising
Meta Adsmeta_adsyoursConnect Meta Ads, where your Connections page offers it

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

Bing Webmaster Tools

IndexNow

YouTube Analytics

Cloudflare

Vercel Web Analytics

Microsoft Advertising (Bing Ads)

Meta Ads

Tools

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.

Sources

ToolWhat it answersKey parametersSourceEffect
list_sourcesWhich vendors this server has, whether each is set up or connected for you, and which questions each answers.nonenone (answers from the server itself)Reads

Keyword research

ToolWhat it answersKey parametersSourceEffect
keyword_volumeAverage 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, limitgoogle_ads, microsoft_ads, bing_webmasterReads
keyword_ideasRelated 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)google_ads, microsoft_ads, bing_webmaster (seeds only)Reads
keyword_forecastExpected 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, languagegoogle_ads, microsoft_adsReads
find_locationsThe ids the other tools take in locations, for countries, regions, cities and postcodes, when a plain name is ambiguous.names (up to 25), country, limitgoogle_ads, microsoft_adsReads
ToolWhat it answersKey parametersSourceEffect
search_performanceClicks, 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_rowgoogle_search_console, bing_webmasterReads
inspect_urlWhat 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, languagegoogle_search_console, bing_webmasterReads
list_sitesEvery site on the connected account, with its permission level or verification.nonegoogle_search_console, bing_webmasterReads
get_siteOne site and the account's permission on it.sitegoogle_search_console, bing_webmasterReads
list_sitemapsThe sitemaps submitted for a site: URLs submitted and indexed, last download, errors and warnings.site, sitemap_indexgoogle_search_console, bing_webmasterReads
get_sitemapOne submitted sitemap: what it holds, how much is indexed, its errors and warnings.site, sitemapgoogle_search_console, bing_webmasterReads
list_sitemap_urlsThe 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_consoleReads
submit_sitemapSubmits (or resubmits) a sitemap URL for a site, so the search engine reads it again.site, sitemapgoogle_search_console, bing_webmasterChanges your account
remove_sitemapRemoves a submitted sitemap from a site.site, sitemapgoogle_search_console, bing_webmasterChanges your account
add_siteAdds 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.sitegoogle_search_console, bing_webmasterChanges your account
remove_siteRemoves a site from the account.sitegoogle_search_console, bing_webmasterChanges your account

Indexing and links

ToolWhat it answersKey parametersSourceEffect
submit_urlsTells 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), checkindexnow, bing_webmasterSends URLs to the search engines (nothing with check: true)
inbound_linksLinks 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, pagebing_webmasterReads

Places

ToolWhat it answersKey parametersSourceEffect
search_placesLooks 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_mapsReads
place_detailsOne 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_mapsReads
place_reviewsPublic 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), languagegoogle_mapsReads

YouTube

ToolWhat it answersKey parametersSourceEffect
video_statsPublic 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_descriptionyoutubeReads
channel_statsPublic 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_descriptionyoutubeReads
channel_videosA channel's most recent uploads with each video's public numbers.channels (up to 10), max (default 50, up to 500), published_after, sortyoutubeReads
search_videosSearches 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, durationyoutubeReads
video_commentsA video's top-level comments with likes and reply counts.videos (up to 10), max (up to 100), order, searchyoutubeReads
youtube_analyticsYour 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, limityoutube_analyticsReads

Site traffic

ToolWhat it answersKey parametersSourceEffect
list_analytics_sitesThe sites a web-analytics source can report on: every Cloudflare zone the token reads, or every Vercel project with its domains.nonecloudflare, vercelReads
site_trafficA 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, vercelReads
traffic_breakdownA 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, vercelReads

Your ad accounts

ToolWhat it answersKey parametersSourceEffect
list_ad_accountsYour own ad accounts: id, name, currency, time zone and status, and Microsoft's account number and pause reason.nonebing_ads (and meta_ads where it is offered)Reads
list_ad_campaignsThe 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.account, level, status, campaign_ids, adset_ids, limitbing_ads (and meta_ads where it is offered)Reads
ad_performanceHow 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, limitbing_ads (and meta_ads where it is offered)Reads

Apps

ToolWhat it answersKey parametersSourceEffect
search_appsApps 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_storesReads
check_app_nameWhether 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.names (up to 10), country, domains (default com, app, ai), package_idsapp_storesReads

Limits and quotas

Daily limits (free beta)

Each account may make, per day (UTC):

WhatPer day
Vendor calls in total300
of which keyword planner calls (keyword_volume, keyword_ideas, keyword_forecast)50
of which Google Maps calls (search_places, place_details, place_reviews)100

Size of one call

ToolMost per call
keyword_volume1,000 keywords (Google Ads, Microsoft Advertising); 50 on Bing Webmaster Tools
keyword_ideas20 seeds; up to 1,000 ideas back
keyword_forecast200 keywords; 1-365 days
find_locations25 names, 10 matches each
search_performance100,000 rows (default 1,000)
inspect_url20 URLs
list_sitemap_urls50,000 URLs (default 1,000); up to 50 sitemap files read
submit_urls10,000 URLs
search_places5 queries, 20 places each
place_details / place_reviews10 places / 5 places, 5 reviews each
video_stats / channel_stats200 videos / 50 channels
channel_videos10 channels, 500 uploads each
search_videos / video_comments5 searches of up to 50 results / 10 videos of up to 100 comments
traffic_breakdown100 rows
list_ad_campaigns / ad_performance5,000 rows read
search_apps / check_app_name10 queries, 50 apps per store / 10 names, 6 domains

Vendor quotas and data ranges

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:

ToolsReused for up to
keyword_volume, keyword_ideas, keyword_forecast, find_locations, search_places, place_details, place_reviews24 hours
search_performance, inbound_links, channel_stats, search_videos, youtube_analytics, search_apps, check_app_name6 hours
inspect_url, get_site, list_sitemaps, get_sitemap, list_sitemap_urls, video_stats, channel_videos, video_comments, site_traffic, traffic_breakdown, list_ad_accounts1 hour
list_ad_campaigns, ad_performance15 minutes
list_sites, list_analytics_sites10 minutes
submit_sitemap, remove_sitemap, add_site, remove_site, submit_urls, list_sourcesnever cached

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

MessageWhat 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

MessageWhat 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

MessageWhat 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

MessageWhat 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

MessageWhat 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

MessageWhat 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

MessageWhat 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)

MessageWhat 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

See the privacy policy and the terms of service. Questions: support@buildershq.net.