merchant-center-mcp
Provides read-only access to Google Merchant Center diagnostics via the Merchant API v1, including account info, feed/datasource status, catalog reports using Merchant Center Query Language (MCQL), and product issue retrieval.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
merchant-center-mcp
MCP server for Google Merchant Center diagnostics via the Merchant API v1 (gRPC): account info, feed/datasource status, and catalog reports via Merchant Center Query Language (MCQL). Read-only — no tool can modify a live catalog.
Tools (4)
Tool | What it does |
| Basic account info (name, ID, language, timezone, test flag) |
| Feeds configured on the account (primary, supplemental, local inventory...) |
| Run an MCQL query against any Reports API view ( |
| Shortcut over |
⚠️ Reports API scope note: it only works on standalone accounts or individual sub-accounts, not on "advanced" (aggregator/MCA) accounts.
⚠️ MCQL limitation: the repeated field item_issues can't be filtered in
a WHERE clause. get_product_issues works around this by pulling
product_view and filtering client-side in Python (capped at 5000 scanned
rows by default).
Related MCP server: Google Ads MCP
Setup
Create a Google Cloud project (or reuse one) and enable the Merchant API.
Create an OAuth 2.0 Client ID of type "Desktop app" and download it as
client_secret.json.If the app is in "Testing" mode, add your Google account as a test user.
Install dependencies:
python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txtRun the OAuth flow once:
CLIENT_SECRET_PATH=~/.config/merchant-center-mcp/client_secret.json python3 setup_auth.pyThis opens a browser — log in and grant access. The token is saved to
~/.config/merchant-center-mcp/token.jsonby default (setTOKEN_OUTto use a different path for a second account).
MCP client configuration
{
"mcpServers": {
"merchant-center": {
"command": "/path/to/.venv/bin/python3",
"args": ["/path/to/merchant-center-mcp/server.py"]
}
}
}Env var | Default | Purpose |
|
| Path to the token file generated by |
For a second account, point a second server instance at the token file you
generated with TOKEN_OUT=~/.config/merchant-center-mcp/token_other.json.
Security
All tools carry the MCP spec's Tool Annotations (
readOnlyHint=true,destructiveHint=false,idempotentHint=true,openWorldHint=true) — accurate, since this server never writes anything.Execution errors propagate as real MCP protocol errors (
isError=true), never as a JSON payload disguised as a success response.
Notes
Gone in favor of Merchant API v1: the Content API for Shopping it replaces was sunset in 2026. If you're still targeting the old API, this server won't help — migrate first.
search_report/get_product_issuespaginate through the gRPC response stream and stop oncelimitrows are collected — they don't fetch the whole result set up front.
License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read-only Search Console analytics, URL inspection, indexing diagnostics, and sitemaps.
Read-only MCP access to your DEXUN AdWhiz account: ad accounts, AI recommendations, savings.
Read-only Google Search Console and Google Analytics for AI agents.
Provides read access to your GKE and Kubernetes resources.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides read-only access to Google Ads account data including campaigns, ad groups, keywords, and performance reports. Enables querying via GAQL through an MCP interface.MIT
- AlicenseNot gradedqualityBmaintenanceEnables read-only inspection of Google Ads accounts through MCP, including account inventory, reporting, metadata, change history, and safe GAQL queries.Apache 2.0
- AlicenseAqualityBmaintenanceEnables MCP clients to query Google Analytics 4 reporting and configuration data through 27 read-only tools, including pivots, funnels, realtime reports, Admin API inspection, and diagnostics, with identifiers redacted by default.27Apache 2.0
- AlicenseAqualityBmaintenanceEnables read-only access to Google Ads data through GAQL queries, resource exploration, recommendations, keyword planning and forecasts, and change history across manager and customer accounts.1140 PyPIMIT