Fudge for Shopify
ai.fudge/fudge · v1.0.1 · MCP 2025-11-25
Run your Shopify store with AI: drafts you approve, what to fix, and how your store is doing.
Reachability
reachable
checked 2026-11-21 05:41 UTC
Registry status active
Tools pinned 68
f9d6e5dfa46b
Tools last changed
2026-11-21
Repo last push 2026-11-11
as of 2026-11-21
GitHub stars 1
as of 2026-11-21
Provenance
Registry namespace ai.fudge
(domain verified by the official registry)
Repository
github.com/fudge-ai/fudge-plugin
Remote endpoints
https://mcp.fudge.ai/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:41 | tools changed | 0 added, 0 removed, 3 changed |
| 2026-11-19 05:39 | tools changed | 2 added, 0 removed, 5 changed |
| 2026-11-17 05:37 | tools changed | 2 added, 0 removed, 4 changed |
| 2026-11-15 05:34 | tools changed | 7 added, 0 removed, 1 changed |
| 2026-11-13 05:32 | tools changed | 0 added, 0 removed, 3 changed |
| 2026-11-12 05:32 | tools changed | 0 added, 0 removed, 2 changed |
| 2026-11-11 05:30 | first capture | 57 tools pinned |
Pinned tool definitions (68)
| Tool | Description |
|---|---|
| list_stores | List the Shopify stores this connection can use. |
| record_discovery_source | 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. |
| connect_store | 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. |
| get_store_overview | 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.... |
| search_design_references | 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. |
| show_design_references | Show 3–8 Lookbook references as a gallery of screenshots, best first, each with a one-sentence note on why it suits this store. |
| get_store_performance | 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,... |
| run_seo_tool | Run one of Fudge’s SEO lookups for the store by id, with the same result the merchant gets from Fudge, such as a keyword lookup. A paid lookup spends the store’s daily SEO tool budget, shared with the merchant and Fudge’s agents, and is... |
| get_store_insights | 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... |
| get_design_guide | 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. |
| search_guides | Search Fudge’s reference articles on SEO, AI discovery, conversion, merchandising, content, store design and analytics. Returns matching paths and excerpts. |
| read_guide | Read one of Fudge’s reference articles by path, such as seo/audit.md. Without a path, lists them all. |
| find_context | Search what Fudge knows about this store: memory guides, Plans, projects, findings, recommendations, recorded changes, messages between Fudge’s agents and past conversations. Pass `about` (a URL, Shopify GID or fudge:// ref) for... |
| read_store_activity | Who is working on this store right now and what happened recently, in one call. `now`: running and queued work, with `startedBy` for an SEO agent’s run (its schedule, a store event, the merchant’s Run now, a message from another agent,... |
| remember | 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. |
| record_change | 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. |
| read_store_document | Read a store document by path: Plans (.plans), playbooks (.playbooks), memory and design guide (.memory), brand kit (.brand) and projects (.projects). Also the store’s SEO and AI search reports, the same numbers the merchant sees in... |
| edit_store_document | 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. |
| create_store_document | Create a document inside an existing Plan, such as .plans/<slug>/brief.md, or with `replace` rewrite a whole document that was just read. |
| create_plan | 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. |
| list_store_audits | List the audits Fudge can run for this store: the Knowledge Base diagnostic, 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... |
| run_ai_readiness_check | Run Fudge’s free AI visibility audit: whether ChatGPT, Google AI Mode and Gemini name, cite or show the store for shopping questions in its main market, with a score and prioritized fixes. Takes about 5 minutes and waits up to 45... |
| run_catalog_data_audit | Run Fudge’s free product schema and catalogue audit: product markup, categories, product details and whether AI buyer searches find the right products, with a score and prioritized fixes. Waits up to 45 seconds. Reuses a running or... |
| run_knowledge_base_check | 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... |
| run_seo_report | 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... |
| check_ai_visibility | 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... |
| find_page_two_pages | 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... |
| find_missing_pages | 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... |
| check_product_schema | 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... |
| run_bfcm_audit | 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... |
| get_store_audit_result | Read the latest full audit: status, result card and report links. Quick checks are previews, not completed audits. A previous successful report is linked separately when the latest run has not completed. Reading starts nothing.... |
| read_audit_evidence | Read complete retained evidence from a free audit run, including full AI answers, sources, product records and findings. Discovers named collections, then returns selected records with explicit pagination and availability. Reads only;... |
| list_audit_runs | List retained free audit runs for the store, newest first, with stable run ids, dates and a continuation cursor. Reads only; never starts collection or spends audit allowance. |
| check_page_speed | Measure a store page with Google PageSpeed Insights: Lighthouse score and lab metrics, real-visitor Core Web Vitals, the largest improvement opportunities and a diagnosis of the cause (LCP element and phases, request chain,... |
| check_store_technical | 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. |
| check_page | Check one live store page’s server HTML for SEO and structured data, as browsers and Google read it: page head, title, canonical, noindex, structured data in JSON-LD, microdata or RDFa, lang, viewport, image alt text, mixed content and... |
| start_website_redesign | 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. |
| start_store_builder | 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. |
| check_catalog_data | 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... |
| search_catalog | 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. |
| list_offers | 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. |
| capture_page | 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. |
| get_keyword_metrics | 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. |
| find_keyword_ideas | 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. |
| get_search_results | 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. |
| get_ranked_keywords | 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... |
| list_work | 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. |
| read_work | 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://... |
| message_fudge | 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.... |
| stop_work | Stop Fudge’s reply running on one work item. With `runId`, stops only that run. The draft and anything already saved stay. |
| request_publish_review | 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. |
| open_fudge_home | 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. |
| show_draft | Show a Fudge draft in the side panel with its screenshot, saved time, change count and links. Without a ref, lists recent drafts. |
| start_draft | 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... |
| read_draft_file | 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... |
| search_draft_files | Find theme files in a Fudge draft. With `pattern`, search contents by regular expression; without it, list files matching `paths` globs. |
| edit_draft_file | 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. |
| write_draft_file | 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... |
| delete_draft_file | 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. |
| edit_draft_content | 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"... |
| create_draft_product | 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. |
| create_draft_collection | 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_draft_page | 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_draft_article | Create a new blog article in a Fudge draft. It can be previewed in the draft and goes live when the merchant publishes. |
| show_preview_consent | 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. |
| set_preview_consent | Record the merchant’s answer from the preview consent card, with the answer code only that card receives. |
| send_feedback | Send the Fudge team a problem with its tools, a capability you needed, or feedback the merchant asked you to pass on. |
| show_resources | Show Fudge items to the merchant as rows that open in Fudge: work, Plans, findings, recommendations, reports, products and pages. |
Get alerted when this changes.
Email the moment ai.fudge/fudge drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/ai.fudge/fudge)
Maintain this server? Add the badge to your README. It links your users to this live status page.