Borrowing it
Nothing to install: this file belongs to A1-x-Tech/mcp-google-merchants. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/A1-x-Tech/mcp-google-merchants/main/CLAUDE.mdgit clone --depth 1 https://github.com/A1-x-Tech/mcp-google-merchantsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/a1-x-tech/mcp-google-merchants/claude-md)<a href="https://agentmods.dev/instructions/a1-x-tech/mcp-google-merchants/claude-md"><img src="https://agentmods.dev/badge/instructions/a1-x-tech/mcp-google-merchants/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/a1-x-tech/mcp-google-merchants/claude-md"><img src="https://agentmods.dev/badge/instructions/a1-x-tech/mcp-google-merchants/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.02058 | $0.02058 |
| Opus 5.5 | $0.00823 | $0.00823 |
| Sonnet 5.5 | $0.00412 | $0.00412 |
| Haiku 4.5 | $0.00206 | $0.00206 |
Grade A, and why
mcp-google-merchants CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 122 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md — mcp-google-merchants
MCP server for Google Merchant Center via the Merchant API v1 (TypeScript, stdio).
Single host https://merchantapi.googleapis.com with per-sub-API path prefixes
(accounts/v1, products/v1, datasources/v1, promotions/v1, reports/v1,
issueresolution/v1, quota/v1). Auth is Google OAuth 2.0 (scope
https://www.googleapis.com/auth/content): the client exchanges a refresh token at
https://oauth2.googleapis.com/token and caches the access token, or uses a static
GOOGLE_MERCHANTS_ACCESS_TOKEN. This is a write-capable server: products and
promotions can be created and deleted. Do NOT copy paths or product-ID formats from
Content API for Shopping (content/v2.1, sunset 2026-08-18) or v1beta (shut down
2026-02-28) — v1 product IDs are contentLanguage~feedLabel~offerId, no channel.
Commands
npm run dev # run from source (tsx watch)
npm test # unit tests + dist smoke, no network
npm run typecheck # types for src + tests
npm run build # emit dist/
npm run smoke # live READ-ONLY call (needs real credentials)
Architecture
src/config.ts— env → config. Credentials: the OAuth trio (GOOGLE_MERCHANTS_CLIENT_ID/_CLIENT_SECRET/_REFRESH_TOKEN— all three orConfigErrorincomplete_oauth, whose message lists the missing variables) orGOOGLE_MERCHANTS_ACCESS_TOKEN; optionalGOOGLE_MERCHANTS_ACCOUNT_ID,_API_BASE,_TOKEN_URL,_TIMEOUT_MS,_MAX_RETRIES. No credentials at all is NOT an error: the fields stayundefined(empty string = absent) and the server starts degraded. Also home toCredentialsError/MISSING_CREDENTIALS_MESSAGE(opens with the historical startup error verbatim, then names the variables and the restart) andhasCredentials().src/client.ts— all HTTP and all wire mapping: token refresh (cached, shared across concurrent calls, one automatic retry on 401),accountPath()fallback to the configured default account, data-source name expansion, per-endpoint methods with camelCase wire bodies, query-param building.request()resolves the path against the base and rejects any path that escapes to a foreign origin (SSRF guard), retries 429 on any method but 5xx/network errors on GET only, honorsRetry-After, enforces an AbortController timeout that also covers reading the body, and throwsMerchantsError(status, body)(decodes the Google error envelope).src/tools/*.ts— one register fn per domain (accounts,products,datasources,promotions,reports,issues,quota) +raw.ts(raw_request, full method enum, DESTRUCTIVE annotations).util.ts—ok/fail, theREAD_ONLY/WRITE/DESTRUCTIVEannotation constants and shared zod schema factories.src/index.ts— wires everyregister*into the McpServer.loadConfigOrDegraded()catchesConfigError, pingsstartup_failed(fire-and-forget) and degrades the config to "no credentials"; an unconfigured start prependsUNCONFIGURED_PREFIX— plusConfiguration problem: <message>when a ConfigError was caught — to the initializeinstructions, andoninitializedsendsserver_startfor a configured install orunconfigured_start(with the reason) otherwise.src/telemetry.ts— anonymous usage pings (ids/names/versions only, never data or arguments; fire-and-forget, must never block or throw; opt-outASKADS_TELEMETRY=0).server_startmeans "a usable install started";unconfigured_startis a degraded start andstartup_faileda malformed config caught at load — both carry areasonfrom a closed vocabulary (missing_credentials,incomplete_oauth) — never a variable's name or value.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2mo ago First seen · 122 lines · 2,058 tokens per session scan A 93c644682fc5
mcp-google-merchants CLAUDE.md is an instructions file published in the GitHub repository A1-x-Tech/mcp-google-merchants (0 stars, last pushed 13d ago), licensed MIT. It adds 2,058 tokens to every session, about $0.0082 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
mcp-google-merchants CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| mcp-google-merchants CLAUDE.mdA1-x-Tech/mcp-google-merchants | Instructions file | 0 | 13d ago | MIT | A | 2,058 | Claude Code |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 144k | today | MIT | A | 8,130 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 5,685 | GitHub Copilot |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 150k | today | MIT | A | 4,680 | Codex, OpenCode |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 283k | today | MIT | A | 4,342 | Codex, OpenCode |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 3,153 | GitHub Copilot |