Fudge for Shopify MCP server

Screenshot one store page in a real browser on desktop and/or mobile and return the images. Pass `draft` to see a Fudge draft. `fullPage` captures top to bottom. Takes 15–60 seconds; up to 50 captures per store per day.

Asks the public ChatGPT, Google AI Mode and Gemini apps 18 shopping questions written from a Shopify store’s catalogue in its market’s language, plus what the store is known for and, on ChatGPT, its returns and free shipping. Reports an AI visibility score; how often each assistant names the store, cites its pages or shows its products, by product line; who the answers name most often and which sources they cite; how AI describes the store; and whether ChatGPT states its return window and free-shipping threshold correctly. Real app answers, signed out, not model APIs. Free, no sign-in; waits up to 45 seconds, the first answers arrive within a minute and the rest within about 5. Shared per store for a day; unmeasured items are reported as unknown.

Check catalogue data coverage across published products, collections, pages and articles: taxonomy, SEO fields, product type, vendor, description, images, alt text and optionally GTIN and MPN. Without `type`, totals and per-field coverage; with `type`, the items missing fields, a page at a time. The first call scans the live catalogue and can return status "scanning". Results are kept for an hour.

Check one live store page’s server HTML for SEO and structured data: title, meta description, canonical, noindex, headings, Open Graph, JSON-LD, lang, viewport, image alt text, mixed content and word count.

Measure a store page with Google PageSpeed Insights: Lighthouse score and lab metrics, real-visitor Core Web Vitals and the largest improvement opportunities. Each device takes 10–30 seconds; results are cached for an hour. On a password-protected store, only real-visitor data is available.

Checks up to 12 of a Shopify store’s product pages, spread over product types, sale and stock, against Google’s merchant listing and product rich result rules, using Google’s Required, Recommended and Agreement levels and wording. It compares each page’s markup with Shopify’s own product data and Shopify Catalog, checks the product list for missing descriptions, images, brands, categories and buyer details and whether Shopify Catalog searches find the right products, and, when the markup lacks the store’s policies, returns a paste-ready return and shipping policy JSON-LD block built only from its own policy pages, saying where in the theme it goes. Free, no sign-in; waits up to 45 seconds of a run’s usual 2–4 minutes. Shared per store for an hour. Anything it could not check is reported as unknown.

Check the live store’s crawlability for search and AI: robots.txt rules, /llms.txt, sitemap.xml, password protection and whether products are publicly reachable.

Create a link the merchant opens to connect another Shopify store. Use when they ask to add a store. The link works once within 10 minutes.

Create a new blog article in a Fudge draft. It can be previewed in the draft and goes live when the merchant publishes.

Create a new hidden collection in a Fudge draft. It is deleted if the draft is discarded and goes live when the merchant publishes. Use only when the merchant asks.

Create a new Shopify page in a Fudge draft, optionally with its own template. It can be previewed in the draft and goes live when the merchant publishes.

Create a new hidden product in a Fudge draft, with options, variants, prices and media. It is deleted if the draft is discarded and becomes active when the merchant publishes. Use only when the merchant asks.

Start a new Plan for a goal the merchant has agreed and no existing Plan covers, with a title, areas, milestones and an optional brief. Schedules and recurring work are approved in Fudge.

Create a document inside an existing Plan, such as .plans/<slug>/brief.md, or with `replace` rewrite a whole document that was just read.

Delete a theme file from a Fudge draft, or stage removal of an item by its .entities path. Fudge refuses deletions that would break references. Publishing applies the removal; until then it can be undone.

Change products, collections, pages, articles, blogs and their metafields in a Fudge draft with sparse patches, many items in one call. - Name only the fields you change; nested objects such as seo merge per key. - Rows with an "id" (variants, options, media) merge by id; omit "id" to add a row; {"id": …, "_delete": true} removes one. Variants and media live at .entities/product/{id}/variants.jsonc and media.jsonc. - Lists such as tags take a full array or {"add": […], "remove": […]}. - Metafields: .entities/product/{id}.metafields with {"namespace.key": {"type": …, "value": …}}; "value": null removes one. Changes to existing items are staged for the merchant’s review. Items the draft created change in Shopify at once.

Change part of a theme file or .entities document in a Fudge draft by replacing exact text, without line gutters. Fudge validates the result and refreshes the preview.

Change part of a store document, such as a Plan’s brief or the design guide, by replacing exact text. Fails if the text is gone or the document has changed since it was read.

Search what Fudge knows about this store: memory guides, Plans, projects, findings, recommendations, recorded changes and past conversations. Pass `about` (a URL, Shopify GID or fudge:// ref) for everything related to one thing. Conversation results say whether the work is a draft, was published or was only discussed.

Find longer search phrases containing a seed keyword, with volume, difficulty and intent. Changes nothing and uses no credits; each store has a daily limit.

Builds the Google searches for what a Shopify store sells from its catalogue (each kind of product with its attributes and audiences), keeps those a model judges are for its products, and checks the largest it has no collection for on Google today. Returns the missing pages worth building, with monthly searches and who ranks, and collections Google doesn’t show for searches they cover. Uses DataForSEO Google data and the store’s public catalogue. Free, no sign-in; waits up to 45 seconds of a run’s usual 1–4 minutes. Shared per store for 7 days. Anything it could not judge is reported as unknown, never as a finding.

Finds a Shopify store’s collections, pages and articles that rank #4–20 on Google in the store’s market (DataForSEO rankings), checks the most valuable on Google today, and gives each one’s searches, monthly volumes, a range of extra clicks from reaching #3 and the change it needs, plus pages that were near page one and have left the top 20, with the cause found. One rewritten title is previewed as a Google result. Free, no sign-in; waits up to 45 seconds of a run’s usual 1–4 minutes. Shared per store for 7 days; anything not measured is reported as not checked.

Read the store’s design guide: colours, typography, spacing, components and brand voice. Use when designing or reviewing pages. With no guide yet and a distinctive theme, this starts a one-time extraction.

Get Google search volume, difficulty, intent, CPC and 12-month history for specific keywords in one country. Missing values are unknown, not zero. Changes nothing and uses no credits; each store has a daily limit.

List the Google searches a domain ranks for in one country, with position, URL, volume, difficulty and estimated traffic. Defaults to this store; pass a competitor’s domain to compare. Changes nothing and uses no credits; each store has a daily limit.

Read Google’s live first results page for one search in one country: ranked results, features, AI Overview citations, People Also Ask and related searches. Changes nothing and uses no credits; each store has a daily limit.

Read the latest run of one free diagnostic: status, report link and, once complete, the score and top fixes. Reading starts nothing. `waitSeconds` waits up to 50 seconds for a running report.

Read the findings and recommendations Fudge has saved for this store, most important first; narrow by area, subject, kind, date or text. With `ref`, one record in full with its sources and measurements. An empty list means nothing is saved yet. This never starts an investigation.

Read a store’s overview: business context, standing memory, Google connection, work waiting on the merchant, Plans, top recommendations and recent results. With `area`, that area’s findings, Plans, work, outputs and headline numbers. Use for a brief or before planning work.

Measure the store, or a product, collection, page, article or URL given as `subject`. `metrics` returns headline values with their previous period, definition and source. `breakdown` returns ranked rows such as queries, landing pages, channels, AI assistants, devices, countries, products or discount codes. With neither, returns what exists for the subject. Periods default to the 28 days ending three days ago against the 28 days before. Google Analytics, Search Console and Shopify are separate measurements.

List the store’s current offers: Fudge offers, active Shopify discounts, native bundles, and shipping rates by zone or market with their free-shipping conditions. Use for an offers or average-order-value review.

List the audits Fudge can run for this store: three diagnostics, free SEO and BFCM audits and eight agent reviews, with each one’s latest result: a free audit’s status, check date, headline, score and result page. Listing starts nothing and spends nothing.

List the Shopify stores this connection can use.

List Fudge work for this store, including work started in Fudge or another assistant. `view: "needs_you"` returns what is waiting on the merchant. `query` searches past work.

Ask Fudge to do work for this store: build or revise a page, article or other draft, investigate, or answer a question. Without `ref`, starts a new conversation; with `ref`, continues that work. Uses the store’s Fudge credits. `requestId` makes retries deliver once. Publishing always needs the merchant’s own approval in Fudge.

Open Fudge Home for a store: work waiting on the merchant, the next recommended step and the four growth areas. Use when the merchant asks to open Fudge or see their store at a glance.

Read a file in a Fudge draft: a theme file, a theme folder listing, or a content document under .entities (list with .entities/product?query=…). Each line starts with a gutter ending at its first tab, numbered on the first, last and every tenth line; long files return `line_offset`. Theme files return a `revision`. Append #info to see where a theme file is used.

Read one of Fudge’s reference articles by path, such as seo/audit.md. Without a path, lists them all.

Read a store document by path: Plans (.plans), playbooks (.playbooks), memory and design guide (.memory), brand kit (.brand) and projects (.projects). Omit `path` to list top-level folders; a folder path lists its documents.

With `ref`: one work item’s live state, progress, latest result, what it is waiting for, and draft or publication state with links; `waitSeconds` waits up to 50 seconds. With `about` (a URL, path, Shopify GID, theme file or fudge:// ref): what has changed there, by `view` current, history or summary. `about: "fudge://store"` is the store-wide timeline.

Add a change made outside Fudge to the store’s timeline, such as ads, prices, apps, email, shipping or theme edits in Shopify, so later results can be attributed. Fudge’s own publishes are recorded automatically.

Save how the merchant heard about Fudge during setup. Record only their stated answer, or null if they explicitly skip. Never infer the source. Existing answers and skips are preserved; this changes no storefront content.

Save a lasting rule, decision, correction or learning to store memory. Use when the user states how things should be done from now on, not for one-off requests. Duplicates change nothing; a contradiction comes back as a conflict.

Prepare a finished draft for the merchant’s publish decision. Returns the link to Fudge’s review page, what will change and whether publishing needs a plan. This does not publish; only the merchant can, in Fudge.

Run Fudge’s free AI Readiness report: whether AI assistants can find and recommend the store’s products, with a score and prioritized fixes. Takes about 3 minutes and waits up to 45 seconds. Returns a run in progress or a result from the last 24 hours unless `fresh` is true.

Checks a Shopify store’s Black Friday readiness in four scored parts: gift searches its products fit (real monthly Google searches and the store’s position today, in its main market or the one `country` names), who is #1 for the store’s own "<brand> black friday" search and whether its sale states dates, how to get the discount and what’s included, its return, shipping and delivery details, and whether its public Shopify AI answers those questions correctly. Every problem comes with evidence and a fix brief. Free, no sign-in; waits up to 45 seconds, then returns progress and report links. Anything it could not check is reported as unchecked with its reason, never scored.

Run Fudge’s free AI shopping catalogue report: categories, structured data, product details and whether buyer searches find the right products. Takes 2–4 minutes and waits up to 45 seconds. Returns a run in progress or a result from the last 24 hours unless `fresh` is true.

Run Fudge’s free Shopify Knowledge Base report: 15 shopper questions with the exact answers, gaps and conflicts with published information. Takes 2–5 minutes and waits up to 45 seconds. Returns a run in progress or a result from the last 24 hours unless `fresh` is true.

Run Fudge’s free SEO report on a Shopify store: a score out of 100 averaged from its page-two, missing-pages, AI-visibility and product-schema audits, which it runs together, and a short list of what to do first. It adds the store’s Google ranking counts, whether Google can read the store (robots.txt, home page title, theme files), buttons on the home page and one product page that lead nowhere, how its articles rank, real-visitor phone speed from the Chrome UX Report and one improved title previewed as a Google result. Free, no sign-in; waits up to 45 seconds, and the full report takes about 3–7 minutes. Shared per store for a day; anything not measured is reported as unknown.

Find the store’s products, collections, pages and articles by name or handle, or list them by type. Matches singular, plural and partial words, and returns close matches when nothing matches every word.

Search Fudge’s Lookbook of analysed ecommerce stores, pages and patterns. Describe the shopper problem or page element, not a brand. Use when the merchant wants to see how other stores solve something.

Find theme files in a Fudge draft. With `pattern`, search contents by regular expression; without it, list files matching `paths` globs.

Search Fudge’s reference articles on SEO, AI discovery, conversion, merchandising, content, store design and analytics. Returns matching paths and excerpts.

Send the Fudge team a problem with its tools, a capability you needed, or feedback the merchant asked you to pass on.

Record the merchant’s answer from the preview consent card, with the answer code only that card receives.

Show 3–8 Lookbook references as a gallery of screenshots, best first, each with a one-sentence note on why it suits this store.

Show a Fudge draft in the side panel with its screenshot, saved time, change count and links. Without a ref, lists recent drafts.

Ask the merchant, with a card, whether new products and collections in a draft may be previewed by direct link on their live store. Use when a result says previewing needs their consent.

Show Fudge items to the merchant as rows that open in Fudge: work, Plans, findings, recommendations, reports, products and pages.

Open a private Fudge draft to build in directly. Fudge copies the live theme into a draft with its own preview. Give a short title and the storefront `page`, or `work` to continue existing work. `requestId` makes retries create one draft. Use for precise changes you make yourself; needs a Fudge plan that includes building.

Start Fudge’s free AI store builder for someone with a store idea but no store yet. It works out a name, logo and brand, then shows store concepts on Fudge’s website. Returns a link for them.

Start Fudge’s free website redesign for a Shopify store, which generates three homepage concepts on Fudge’s website. Use when the merchant wants new design directions for their whole site. Returns a link for them.

Stop Fudge’s reply running on one work item. With `runId`, stops only that run. The draft and anything already saved stay.

Create a new theme file in a Fudge draft, or with `replace` rewrite a whole file. New theme filenames include the draft’s file prefix, except templates, config and locales. Every sections/*.liquid file needs a {% schema %} with a non-empty "name".