Hexagon MCP
Provides access to Google Ads Keyword Planner for keyword research, returning search volume, competition, and CPC data for seed keywords across target locations, date ranges, and networks.
Enables querying Google Search Console data, including queries, pages, clicks, impressions, CTR, position, and any other dimension or metric the Search Console API supports.
Provides two Reddit-based signals: Trends surfaces rising posts from specified subreddits, and Demand surfaces recommendation and buying-intent threads as a demand proxy for content decisions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Hexagon MCP How did my organic traffic and AdSense revenue do last week?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Hexagon MCP
A read-only MCP server that lets an AI assistant like Claude read your own site data directly: Google Search Console, GA4, AdSense, Keyword Planner and Reddit. No exporting reports, no pasting screenshots into a chat. You ask a question, the assistant calls the right tool and answers from the rows it gets back.
Six sources, six tools, one server. Hence the name.
Built by Smallware Co.. Landing page: engineeredai.net/tools/hexagon-mcp. Privacy policy: engineeredai.net/tools/hexagon-mcp/privacy.
Status
Version 0.1.0. Search Console, GA4, AdSense and Keyword Planner are tested and working. The two Reddit tools are written but have not been tested against live credentials yet, so treat them as experimental. Transport is stdio, so any MCP client that can launch a local command can run it.
Related MCP server: Google Search Console MCP Server
Tools
Tool | What it returns |
| Clicks, impressions, CTR and position from Search Console, by query, page, country, device or date. One property, or every property the account can access. |
| Any GA4 Data API dimensions and metrics. Defaults to top pages by views for the last 7 days. One property, or all of them grouped per property. |
| Estimated earnings, page views, impressions, clicks and CTR by day for the last 7 days by default, so highs and lows are visible without opening the dashboard. Other dimensions and date ranges are available. |
| Average monthly searches, competition (LOW, MEDIUM or HIGH) and top of page bid range for seed keywords, by location, language, network and month range. |
| Rising posts from the subreddits you name. A "what is picking up in my niche" signal that does not depend on Google Trends. |
| Recommendation and buying intent threads in your niche, as a demand signal for product and affiliate content. |
Every tool is read-only. Nothing is created, changed or deleted on any platform.
Example
Ask your assistant something like:
"Which queries across my sites got impressions but almost no clicks in the last 30 days?"
"Show my AdSense earnings by day for the last 7 days."
"Give me Keyword Planner ideas for 'mcp server' in the US."
For the first question the assistant calls gsc_query once with every property included, and each property comes back with rows shaped like this (values are illustrative):
{
"siteUrl": "https://example.com/",
"rows": [
{ "query": "example query", "clicks": 3, "impressions": 54, "ctr": 0.0556, "position": 5.8 }
]
}Who it is for
Solo operators and small content teams who want to understand what is working and what is worth writing about next, without a dedicated SEO hire or an agency retainer. It does not replace judgment or strategy. It removes the manual step of exporting a report or scanning several tabs before you can start asking questions.
Bring your own credentials
Hexagon ships with no credentials and stores none. You authenticate with your own accounts, and everything runs on your own machine. There is no Hexagon server, no account and no telemetry.
Each tool only works if its credentials are in .env. A tool with missing credentials returns an error naming the missing variables, and the other tools keep working. You can set up Search Console and GA4 first and add the rest later.
You will need:
A Google Cloud project with the Search Console API, Analytics Data API and AdSense Management API enabled. Enable the Google Ads API too if you want Keyword Planner.
An OAuth client of type Desktop app from that project (client ID and secret).
For AdSense, your publisher ID in the format
pub-XXXXXXXXXXXXXXXX.Optionally, a default Search Console property URL exactly as it appears in Search Console (for example
sc-domain:example.comorhttps://example.com/) and a default GA4 property ID. Leave them empty to query every property the Google account can access.For Keyword Planner, a Google Ads developer token, Ads OAuth credentials, a customer ID, and Google Ads API access at the Basic level or higher. See the Keyword Planner section below.
For Reddit, a "script" type app created at reddit.com/prefs/apps.
Setup
git clone https://github.com/smallware-co/hexagon-mcp.git
cd hexagon-mcp
npm install
cp .env.example .envFill in GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in .env, then get a refresh token:
npm run auth:googleOpen the URL it prints, approve access, and the helper prints a GOOGLE_REFRESH_TOKEN=... line. Paste that line into .env. The helper requests read-only scopes for Search Console, Analytics and AdSense, and the token is only printed in your terminal.
Add your AdSense publisher ID, then add Hexagon to your MCP client config. Claude Desktop example:
{
"mcpServers": {
"hexagon": {
"command": "node",
"args": ["/absolute/path/to/hexagon-mcp/src/index.js"]
}
}
}On Windows, use a path like C:\\Users\\you\\hexagon-mcp\\src\\index.js with doubled backslashes. Restart your client and the tools will be available. The .env file is found relative to the server, so it does not matter which directory your client launches it from.
Keyword Planner setup
Steps below were verified in October 2026. Google changes this process, so check each screen against what you see.
Fill in the
GOOGLE_ADS_variables in.env: developer token, client ID, client secret and customer ID.Run
npm run auth:google -- --adsand paste theGOOGLE_ADS_REFRESH_TOKEN=...line into.env. This uses theGOOGLE_ADS_client pair and the Google Ads scope.Check your Google Ads API access level in the Google Cloud Console under the Google Ads API page. New projects start at Test, then Explorer. Keyword Planner calls fail on Explorer with "This method is not allowed for use with explorer access". You need Basic.
To apply for Basic, your OAuth app needs brand verification. On the Branding page of your OAuth consent screen, fill in an app name, support email, home page, privacy policy, terms of service, an authorized domain and a logo that identifies your brand. A generic logo can be rejected with "Your logo does not uniquely identify your brand and identity". After verification passes, publish the branding.
Set
GOOGLE_ADS_CUSTOMER_IDto an account you can reach. If a canceled ad account is refused as "not enabled or deactivated", use your manager account ID instead.GOOGLE_ADS_LOGIN_CUSTOMER_IDis only needed when the customer is reached through a manager account.
Locations accept country codes (US, PH, GB, UK, CA, AU, IN, SG, NZ, IE, DE, FR) or any numeric geo target constant ID.
Troubleshooting
"... is not configured. Missing in .env: ...": that tool's credentials are incomplete. The message names the variables.
"Google did not return a refresh token": remove the app's access at myaccount.google.com/permissions and run the helper again.
"User does not have sufficient permission for site": your
GSC_SITE_URLdoes not match the property exactly as Search Console lists it. Leave it empty to query every property.
What the Google scopes do
The helper requests read-only scopes for Search Console, Analytics and AdSense. For Keyword Planner, Google only offers a broader Google Ads scope, so Hexagon requests it, but only calls the keyword ideas service and does not create or change campaigns, keyword plans or settings. Details are in the privacy policy.
Why not Google Trends?
Trends has no official API. The available workarounds scrape its internal endpoints, so they can break without warning. Reddit's rising endpoint is an official, stable API and surfaces posts that are gaining traction, which is closer to what Trends is meant to show than a plain top posts pull. It is a narrower signal, since Reddit attention is not the same as search demand, but it will not silently stop working.
License
MIT
Available Tools
6 toolsadsense_reportA
Query AdSense performance (read-only). Defaults to earnings, page views, impressions, clicks and CTR by day for the last 7 days.
Inputs: limit, endDate, metrics, dateRange, +2 more.
ga4_reportA
Run a GA4 report (read-only). Defaults to top pages by views for the last 7 days ending yesterday. Accepts any GA4 Data API dimension and metric names, e.g. sessionDefaultChannelGroup, country, activeUsers. Covers one property, or every property the account can access when propertyId is 'all' or omitted.
Inputs: limit, endDate, metrics, startDate, +3 more.
gsc_queryA
Query Google Search Console performance data (read-only). Defaults to queries and pages for the last 7 days ending yesterday, with clicks, impressions, CTR and position. Covers one property, or every property the account can access when siteUrl is 'all' or omitted.
Inputs: endDate, filters, siteUrl, rowLimit, +4 more.
keyword_planner_ideasA
Get Keyword Planner ideas and metrics for seed keywords (read-only): average monthly searches, competition and top of page bid range. Requires a Google Ads developer token.
Inputs: keywords (required), locations (required), limit, network, +3 more.
reddit_demandA
Find recommendation and buying-intent threads for a product category in the subreddits you name (read-only). A demand proxy for affiliate content. Returns title, score, comment count and age so demand can be judged by discussion volume.
Inputs: subreddits (required), productCategory (required), limit, timeframe.
reddit_trendsA
Rising posts from the subreddits you name (read-only), a 'what is gaining traction right now in my niche' signal. Returns title, score, comment count and age per post.
Inputs: subreddits (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool maps to a distinct data source (GSC, GA4, AdSense, Keyword Planner, Reddit), so selection is mostly unambiguous. The only mild overlap is reddit_trends vs reddit_demand, but their descriptions clearly separate 'rising posts' from 'buying-intent threads'.
All names follow a consistent snake_case source_action pattern (gsc_query, ga4_report, adsense_report, reddit_trends, reddit_demand). Minor variation in the action suffix (query vs report vs ideas) is readable and intentional, not chaotic.
Six tools is well-scoped for a read-only marketing-analytics aggregator, with each tool earning its place by covering a distinct data source. No redundant or filler tools.
The surface covers the core read-only research workflows across four Google data sources plus Reddit demand signals. Minor gaps exist (no property/account listing tool, no cross-source synthesis or trend comparison), but agents can work around these.
Maintenance
Related MCP Connectors
Read-only Google Ads, GA4 and Search Console data for Claude, with no Google Cloud setup.
Read-only access for your AI to Search Console, GA4, Google Ads, Meta Ads and your store's sales.
1Search Console, Google Analytics and keyword data for your AI agent.
Marketing data and actions for AI agents: GA4, Search Console, ads, social, SEO and WordPress.
Related MCP Servers
- AlicenseBqualityDmaintenanceConnects Google Search Console to AI assistants, enabling SEO data analysis through natural language conversations.32MIT
- AlicenseNot gradedqualityDmaintenanceConnects Google Search Console to AI assistants, enabling SEO data analysis via natural language conversations.MIT
- AlicenseNot gradedqualityBmaintenanceEnables natural-language, read-only analysis of your own Google Search Console and Google Analytics 4 data, including search performance, engagement, sitemap health, ranking opportunities, and deterministic SEO audits through MCP clients like ChatGPT.MIT
- AlicenseAqualityBmaintenanceEnables querying Google Search Console, GA4, and IndexNow data via natural language, allowing users to ask about site rankings, clicks, indexing status, and conversions.131MIT