MCP.Market

Gmc MCP server

by kiwoongeom·io.github.kiwoongeom/gmc-mcp·v0.2.5·15 stars

MIT-licensed pip-installable MCP for Google Merchant Center on Merchant API v1 (126 tools).

C69/100grade C
What users say
No reviews yet
Be the first
Safety scan
C69/100

full report

Adoption
Growing

15 stars526 downloads/wk

Reviews

Write one

Nobody has reviewed Gmc yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Gmc tools (100, 39 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • gmc_accept_tos

    Accept a TermsOfService.

  • gmc_add_user

    Add a user to the Merchant Center account.

  • gmc_approve_account_service

    Approve a proposed service relationship.

  • gmc_audit_lookup

    Look up an audit log entry by ID. Useful for diagnosing failed writes or rolling back.

  • gmc_audit_tail

    Show the most recent audit log entries.

  • gmc_bulk_delete_productswrite action

    Bulk-delete product inputs. DESTRUCTIVE — requires confirm='DELETE'.

  • gmc_bulk_set_availability

    Bulk-set availability ('IN_STOCK', 'OUT_OF_STOCK', etc.) for many products.

  • gmc_bulk_update_regional_priceswrite action

    Bulk-update regional inventory prices.

  • gmc_claim_homepage

    Claim ownership of the homepage. Set overwrite=True to take over from another claimant on the same domain.

  • gmc_create_aggregationwrite action

    Aggregate this account under a provider (typically an MCA/aggregator).

  • gmc_create_checkout_settingswrite action

    Create URI checkout settings (program is always 'checkout' in v1).

  • gmc_create_conversion_sourcewrite action

    Create a conversion source. Examples:

  • gmc_create_omnichannel_settingswrite action

    Create omnichannel settings for a region.

  • gmc_create_primary_feedwrite action

    Create an API-based primary product feed.

  • gmc_create_supplemental_feedwrite action

    Create an API-based supplemental product feed.

  • gmc_delete_aggregationwrite action

    Remove the current aggregation from a provider.

  • gmc_delete_checkout_settingswrite action

    Delete URI checkout settings (program defaults to 'checkout').

  • gmc_delete_conversion_sourcewrite action

    Soft-delete a conversion source (recoverable via undelete).

  • gmc_delete_datasourcewrite action

    Delete a data source. Cannot delete a primary feed if products depend on it.

  • gmc_delete_productwrite action

    Delete a product input.

  • gmc_describe_server

    Show what this server is connected to and how it's configured.

  • gmc_diff_with_shopify

    Compare a Shopify product CSV (exported from admin) against GMC products.

  • gmc_export_all

    Dump products, issues, datasources, return policies, account info to JSON files.

  • gmc_fetch_datasource

    Trigger an immediate fetch of a file-based data source (must have a fetch URL).

  • gmc_get_account

    Get the current Merchant Center account information.

  • gmc_get_account_tax

    Get US account tax settings.

  • gmc_get_autofeed_settings

    Get autofeed (Google crawls your site to build a feed) settings.

  • gmc_get_automatic_improvements

    Get current automatic-improvements settings (item updates, image, shipping, prices).

  • gmc_get_business_identity

    Get business identity (women-owned, minority-owned, veteran-owned, etc.). Google can show badges on your listings based on these attributes.

  • gmc_get_business_info

    Get business identity info (address, phone, customer service).

  • gmc_get_checkout_settings

    Get URI checkout settings.

  • gmc_get_conversion_source
  • gmc_get_datasource

    Get a single data source by its ID (numeric).

  • gmc_get_email_preferenceswrite action

    Get email-notification preferences for a user. email: the user's email exactly as it appears in Account Access.

  • gmc_get_homepage

    Get the registered homepage URI and its claim status.

  • gmc_get_latest_tos

    Retrieve the latest TermsOfService document.

  • gmc_get_omnichannel_settings
  • gmc_get_product

    Get a single product by its full product ID.

  • gmc_get_product_status

    Get the status (approval, issues, destinations) of a single product.

  • gmc_get_program_review

    Get the current review state of a program (pending/approved/disapproved/etc.).

  • gmc_get_promotion

    Get a single promotion by ID.

  • gmc_get_region

    Get one region by ID.

  • gmc_get_relationship
  • gmc_get_shipping_settings

    Get shipping settings (services, rate groups, delivery times).

  • gmc_health_check

    Probe core endpoints and report which respond. Useful first call after setup.

  • gmc_insert_productwrite action

    Insert or update a product via productInputs (Merchant API v1).

  • gmc_insert_promotionwrite action

    Insert or update a promotion.

  • gmc_lfp_delete_storewrite action
  • gmc_lfp_get_merchant_state

    Get the current LFP onboarding/sync state for a target merchant.

  • gmc_lfp_get_store
  • gmc_lfp_insert_inventorywrite action

    Push one local inventory record. Body example: { "targetAccount": "1234567890", "storeCode": "store-1", "offerId": "SKU1", "regionCode": "US", "contentLanguage": "en", "price": {"amountMicros": "19990000", "currencyCode": "USD"}, "availability": "IN_STOCK", "quantity": "12" }

  • gmc_lfp_insert_salewrite action

    Push one local sale event. Body example: { "targetAccount": "1234567890", "storeCode": "store-1", "offerId": "SKU1", "regionCode": "US", "contentLanguage": "en", "price": {"amountMicros": "19990000", "currencyCode": "USD"}, "quantity": "1", "saleTime": "2026-04-30T19:30:00Z", "uid": "txn-abc123" }

  • gmc_lfp_insert_storewrite action

    Create / upsert an LFP store. Body example: { "targetAccount": "1234567890", "storeCode": "store-1", "storeAddress": "123 Main St, City, ST 00000", "storeName": "Main Street Store", "phoneNumber": "+1-555-0100", "websiteUri": "https://store.com/locations/1" }

  • gmc_lfp_list_stores

    List stores LFP-linked to a target merchant account.

  • gmc_link_gbp_account

    Link a Google Business Profile account so its store locations sync to GMC.

  • gmc_list_account_issues

    List all account-level issues (policy, missing settings, etc).

  • gmc_list_account_services

    List service relationships (where someone delegates account management).

  • gmc_list_conversion_sources

    List conversion sources (Google Tag, Google Analytics, Merchant Center Destination).

  • gmc_list_datasources

    List all data sources (primary, supplemental, file-based, API-based).

  • gmc_list_disapproved_products

    List products that are currently disapproved on Google Shopping.

  • gmc_list_gbp_accounts

    List linked Google Business Profile accounts.

  • gmc_list_local_inventories

    List local inventories for a product.

  • gmc_list_omnichannel_settings

    List per-region omnichannel settings.

  • gmc_list_products

    List all products in the Merchant Center account.

  • gmc_list_programs

    List participation in Merchant Center programs (Shopping Ads, Free Listings, etc.).

  • gmc_list_promotions

    List all promotions in the Merchant Center.

  • gmc_list_quotas

    List the API quota usage / limits for this account.

  • gmc_list_regional_inventories

    List regional inventories for a product.

  • gmc_list_regions

    List all regions configured on the account.

  • gmc_list_relationships

    List parent / child / aggregator relationships involving this account.

  • gmc_list_subscriptions

    List push-notification subscriptions on this account.

  • gmc_list_tos_agreement_states

    List the TOS agreement states for the current account.

  • gmc_list_users

    List users with access to this Merchant Center account.

  • gmc_propose_account_service

    Propose a service relationship (e.g. account management delegation).

  • gmc_reject_account_service

    Reject a proposed service relationship.

  • gmc_remove_userwrite action

    Remove a user from the Merchant Center account.

  • gmc_request_inventory_verification

    Request Google to verify your inventory accuracy in a region.

  • gmc_request_program_review

    Request a manual review of a program after fixing disapproval issues.

  • gmc_rollback

    Roll back a previous write using its audit `before` snapshot.

  • gmc_set_dry_runwrite action

    Toggle dry-run mode for this session. When enabled, write operations are recorded to the audit log but NOT sent to Merchant API.

  • gmc_subscribewrite action

    Create a notification subscription.

  • gmc_summarize_product_issues

    Scan products and aggregate issue codes by frequency.

  • gmc_unclaim_homepage

    Release the homepage claim.

  • gmc_undelete_conversion_source

    Undelete a soft-deleted conversion source.

  • gmc_unsubscribewrite action

    Delete a notification subscription by ID.

  • gmc_update_account_taxwrite action

    Update US tax rules. Body example: [ {"region": "US-CA", "useGoogleRate": True, "shippingTaxed": False}, {"region": "US-NY", "ratePercent": 8.0, "shippingTaxed": True} ]

  • gmc_update_autofeed_settingswrite action

    Enable / disable autofeed product crawling.

  • gmc_update_automatic_improvementswrite action

    Toggle automatic improvements. Body example: { "itemUpdates": {"accountItemUpdatesSettings": { "allowPriceUpdates": True, "allowAvailabilityUpdates": True, "allowConditionUpdates": True, "allowStrictAvailabilityUpdates": True }}, "imageImprovements": {"accountImageImprovementsSettings": { "allowAutomaticImageImprovements": True }}, "shippingImprovements": {"allowShippingImprovements": True} }

  • gmc_update_business_identitywrite action

    Patch business identity. Body example: { "blackOwned": {"identityDeclaration": "SELF_IDENTIFIES_AS"}, "womenOwned": {"identityDeclaration": "SELF_IDENTIFIES_AS"}, "promotionsConsent": "PROMOTIONS_CONSENT_GIVEN_FOR_PROMOTIONS" }

  • gmc_update_business_infowrite action

    Patch business info. Body example: { "address": { "regionCode": "US", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": ["1600 Amphitheatre Pkwy"] }, "phone": {"e164Number": "+14155551234"}, "customerService": { "uri": "https://store.com/contact", "email": "support@store.com", "phone": {"e164Number": "+18005551234"} }, "koreanBusinessRegistrationNumber

  • gmc_update_checkout_settingswrite action

    Patch URI checkout settings (program is always 'checkout' in v1).

  • gmc_update_conversion_sourcewrite action
  • gmc_update_email_preferenceswrite action

    Update email preferences. preferences example: {"newsAndTips": "OPTED_IN"} # or OPTED_OUT

  • gmc_update_homepagewrite action

    Update the homepage URI. update_mask defaults to 'uri'.

  • gmc_update_local_inventorywrite action

    Insert or update local (in-store) inventory for a product (Merchant API v1).

  • gmc_update_omnichannel_settingswrite action
  • gmc_update_productwrite action

    Update a product. Implemented as productInputs:insert (upsert).

  • gmc_update_regional_inventorywrite action

    Insert or update regional inventory for a product (Merchant API v1).

  • gmc_update_relationshipwrite action
  • gmc_update_shipping_settingswrite action

    Update shipping settings. Body must be a complete ShippingSettings object.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan30 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 148 days ago8/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 69/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Gmc compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
69/100
higher than 33% of 48,255 servers
Tools
100
the typical server has 7
Tools that change things
39%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
15
more than 90% of 28,688 servers
Downloads a week
526
more than 89% of 12,191 servers with a package

What its tools let an agent do: 61 read · 39 change

Install Gmc in Claude Code, Cursor or VS Code

claude mcp add gmc-mcp -- uvx gmc-mcp
Add to Cursor

What the publisher says

From the Gmc repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.kiwoongeom/gmc-mcp -->

Google Merchant Center MCP (gmc-mcp)

MCP server for Google Merchant Center, built on Merchant API v1.

126 tools, MIT-licensed, pip install-able. Drive your Google Shopping

feed, products, inventory, Reports, promotions, returns, and account

configuration in natural language from Claude Desktop, Claude Code, or any

MCP-compatible client.

### Where this fits in the GMC + MCP landscape

| Option | Type | API | License | Install | Tools |

|---|---|---|---|---|---|

| Adzviser / Catchr / Windsor.ai / Pipedream | Paid hosted SaaS | varies | proprietary | sign-up | varies |

| archpeng/GMC-mcp-server | Self-hosted | Content API v2.1 (deprecated 2026-08) | none declared | git clone | 34 |

| gmc-mcp (this package) | Self-hosted | Merchant API v1 (future-proof) | MIT | pip install gmc-mcp | 126 |

Pick this if you want: future-proof API, an actual OSS license, PyPI install,

a larger toolset, audit log + rollback + dry-run safety, and credentials that

never leave your machine.

Built on Merchant API v1 (replaces Content API for Shopping; v1beta was discontinued 2026-02-28). Safe by default: every write is recorded to an append-only audit log with before snapshots, dry-run is one toggle away, and destructive bulk operations require an explicit confirm parameter.

Why this exists

Google Merchant Center (GMC) powers Google Shopping listings, Free Listings, Shopping Ads, Buy on Google checkout, YouTube Shopping, and more. Managing a feed of thousands of products through the GMC web UI is tedious, and writing one-off Python scripts against the Merchant API REST endpoints is slow.

There are existing MCP services for GMC, but they fit different niches:

is proxied through their servers; monthly subscription.

  • Paid hosted SaaS (Adzviser, Catchr, Windsor.ai, Pipedream) — your data

but built on the deprecated Content API v2.1 which Google retires in August 2026, has no license declared, and isn't on PyPI.

  • archpeng/GMC-mcp-server — earliest self-hosted Python option (Feb 2026),

gmc-mcp was built to fill the gap: a self-hosted package on the new Merchant API v1, MIT-licensed, on PyPI, with audit/rollback/dry-run safety and 126 tools across 19 modules.

The package gives Claude (or any MCP client) 126 tools that map directly onto the Merchant API v1 surface, so you can do things like:

  • "Show me every disapproved product, grouped by issue code."
  • "Bump US prices 5% on these 40 SKUs."
  • "Which products had impressions but zero clicks last week?"
  • "Roll back audit ID 8fc8dc42… — that update broke something."
  • "Compare this Shopify CSV against my GMC feed; what's missing?"

What's exposed

126 tools across 19 modules + 4 meta tools.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Gmc: common questions

Is Gmc MCP server safe?
With care: it is graded C, so read the findings first (69/100). Read the Gmc safety report
How do I install Gmc?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Gmc need an API key?
Yes. The registry entry asks for GMC_SERVICE_ACCOUNT_KEY, GMC_OAUTH_TOKEN.
Is Gmc maintained?
The last commit was 186 days ago (2026-05-02). The latest release is v0.2.5.
How does Gmc compare with other MCP servers?
safety score 69/100 (higher than 33% of 48,255 servers); tools 100 (the typical server has 7); tools that change things 39% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.