Servers Playground How we check Add a server Log in

Fudge for Shopify

Working Security A

ai.fudge/fudgev1.0.1 Domain verified

Run your Shopify store with AI: drafts you approve, what to fix, and how your store is doing.

Commerce

Watch Source Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-10T15:10:49.387407Z",
      "publishedAt": "2026-11-10T15:10:49.387407Z",
      "statusChangedAt": "2026-11-10T15:10:49.387407Z"
    }
  },
  "server": {
    "name": "ai.fudge/fudge",
    "icons": [
      {
        "src": "https://raw.githubusercontent.com/fudge-ai/fudge-plugin/main/assets/icon.png",
        "sizes": [
          "512x512"
        ],
        "mimeType": "image/png"
      }
    ],
    "title": "Fudge for Shopify",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://mcp.fudge.ai/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "1.0.1",
    "repository": {
      "url": "https://github.com/fudge-ai/fudge-plugin",
      "source": "github"
    },
    "websiteUrl": "https://www.fudge.ai/shopify-mcp-server/",
    "description": "Run your Shopify store with AI: drafts you approve, what to fix, and how your store is doing."
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.fudge.ai/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

capture_page Read-only

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.

pagestring

A store URL or path, e.g. / or /products/blue-runner. Defaults to the home page, or with `draft` to the page the draft is about.

draftstring

A draft’s fudge://project/… ref: capture the page as that draft shows it. Staged product and page content changes appear only on Fudge’s review page, not here.

storestring

The connected store to use. Omit when only one is connected.

devicestring

fullPageboolean

Fudge for Shopify MCP server | mcptry

Fudge for Shopify

Working Security A

ai.fudge/fudgev1.0.1 Domain verified

Run your Shopify store with AI: drafts you approve, what to fix, and how your store is doing.

Commerce

Watch Watch Source Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-10T15:10:49.387407Z",
      "publishedAt": "2026-11-10T15:10:49.387407Z",
      "statusChangedAt": "2026-11-10T15:10:49.387407Z"
    }
  },
  "server": {
    "name": "ai.fudge/fudge",
    "icons": [
      {
        "src": "https://raw.githubusercontent.com/fudge-ai/fudge-plugin/main/assets/icon.png",
        "sizes": [
          "512x512"
        ],
        "mimeType": "image/png"
      }
    ],
    "title": "Fudge for Shopify",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://mcp.fudge.ai/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "1.0.1",
    "repository": {
      "url": "https://github.com/fudge-ai/fudge-plugin",
      "source": "github"
    },
    "websiteUrl": "https://www.fudge.ai/shopify-mcp-server/",
    "description": "Run your Shopify store with AI: drafts you approve, what to fix, and how your store is doing."
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.fudge.ai/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

capture_page Read-only

pagestring

A store URL or path, e.g. / or /products/blue-runner. Defaults to the home page, or with `draft` to the page the draft is about.

draftstring

A draft’s fudge://project/… ref: capture the page as that draft shows it. Staged product and page content changes appear only on Fudge’s review page, not here.

storestring

The connected store to use. Omit when only one is connected.

devicestring

fullPageboolean

Tools (57)

capture_page

read-only

Argument	Type	Description
page	string	A store URL or path, e.g. / or /products/blue-runner. Defaults to the home page, or with `draft` to the page the draft is about.
draft	string	A draft’s fudge://project/… ref: capture the page as that draft shows it. Staged product and page content changes appear only on Fudge’s review page, not here.
store	string	The connected store to use. Omit when only one is connected.
device	string
fullPage	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "string",
      "maxLength": 2000,
      "description": "A store URL or path, e.g. / or /products/blue-runner. Defaults to the home page, or with `draft` to the page the draft is about."
    },
    "draft": {
      "type": "string",
      "maxLength": 200,
      "description": "A draft’s fudge://project/… ref: capture the page as that draft shows it. Staged product and page content changes appear only on Fudge’s review page, not here."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "device": {
      "enum": [
        "desktop",
        "mobile",
        "both"
      ],
      "type": "string",
      "default": "both"
    },
    "fullPage": {
      "type": "boolean",
      "default": false
    }
  }
}

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 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.

read-only

Argument	Type	Description
type	string	List this type’s offenders instead of the summary.
limit	integer
store	string	The connected store to use. Omit when only one is connected.
offset	integer
missing	string	With type: only items missing this field, named as in the summary, e.g. "Meta description".
refresh	boolean	Rescan instead of reusing this hour’s result. Only after the merchant changed catalogue data.
includeProductIdentifiers	boolean	Also check GTIN/barcode and MPN on products. A separate, slower scan.

Input schema (JSON)

check_page

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.

read-only

Argument	Type	Description
page	string	A store URL or path, e.g. / or /products/blue-runner.
store	string	The connected store to use. Omit when only one is connected.
domain	string	The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "string",
      "default": "/",
      "maxLength": 2000,
      "description": "A store URL or path, e.g. / or /products/blue-runner."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "domain": {
      "type": "string",
      "description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store."
    }
  }
}

check_page_speed

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.

read-only

Argument	Type	Description
page	string	A store URL or path, e.g. / or /products/blue-runner.
store	string	The connected store to use. Omit when only one is connected.
device	string
domain	string	The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "string",
      "default": "/",
      "maxLength": 2000,
      "description": "A store URL or path, e.g. / or /products/blue-runner."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "device": {
      "enum": [
        "mobile",
        "desktop",
        "both"
      ],
      "type": "string",
      "default": "both"
    },
    "domain": {
      "type": "string",
      "description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store."
    }
  }
}

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.

read-only

Argument	Type	Description
store	string	The connected store to use. Omit when only one is connected.
domain	string	The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "domain": {
      "type": "string",
      "description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store."
    }
  }
}

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.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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.

Argument	Type	Description
draft*	string	The draft’s fudge://project/… ref.
store	string	The connected store to use. Omit when only one is connected.
article*	object

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "article"
  ],
  "properties": {
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "article": {
      "type": "object",
      "required": [
        "title",
        "blogId"
      ],
      "properties": {
        "title": {
          "type": "string",
          "minLength": 1
        },
        "blogId": {
          "type": "string",
          "description": "GID of the blog to publish the post to at publish time (e.g. \"gid://shopify/Blog/123\"). Read `.skills/blog/index.md` for available blogs and their GIDs."
        }
      }
    }
  }
}

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.

Argument	Type	Description
draft*	string	The draft’s fudge://project/… ref.
store	string	The connected store to use. Omit when only one is connected.
collection*	object

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "collection"
  ],
  "properties": {
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "collection": {
      "type": "object",
      "required": [
        "title"
      ],
      "properties": {
        "title": {
          "type": "string",
          "minLength": 1
        },
        "handle": {
          "type": "string",
          "description": "URL handle; derived from the title when omitted."
        },
        "products": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Product ids to include manually."
        },
        "matchType": {
          "enum": [
            "ANY",
            "ALL"
          ],
          "type": "string",
          "description": "Whether products must match any or all conditions."
        },
        "sortOrder": {
          "enum": [
            "ALPHA_ASC",
            "ALPHA_DESC",
            "BEST_SELLING",
            "CREATED",
            "CREATED_DESC",
            "MANUAL",
            "MOST_RELEVANT",
            "PRICE_ASC",
            "PRICE_DESC"
          ],
          "type": "string"
        },
        "conditions": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "field",
              "relation",
              "values"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "field": {
                "enum": [
                  "tag",
                  "title",
                  "type",
                  "vendor",
                  "category",
                  "status",
                  "variantTitle",
                  "price",
                  "compareAtPrice",
                  "weight",
                  "inventory",
                  "metafield",
                  "unsupported"
                ],
                "type": "string"
              },
              "values": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "minItems": 1
              },
              "relation": {
                "type": "string"
              },
              "matchType": {
                "enum": [
                  "ANY",
                  "ALL"
                ],
                "type": "string",
                "description": "For multi-value conditions: match any or all values."
              },
              "definition": {
                "type": "string",
                "description": "metafield conditions only: the metafield definition as \"namespace.key\"."
              }
            },
            "additionalProperties": false
          },
          "description": "Smart-collection rules, e.g. [{field: \"tag\", relation: \"TAGGED_WITH\", values: [\"sale\"]}]. Omit for a manual collection."
        },
        "templateSuffix": {
          "type": "string"
        },
        "descriptionHtml": {
          "type": "string"
        }
      }
    }
  }
}

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.

Argument	Type	Description
page*	object
draft*	string	The draft’s fudge://project/… ref.
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "page"
  ],
  "properties": {
    "page": {
      "type": "object",
      "required": [
        "title"
      ],
      "properties": {
        "title": {
          "type": "string",
          "minLength": 1
        },
        "createCustomTemplate": {
          "type": "boolean",
          "default": true,
          "description": "Create a fresh custom template for this page (default true). False uses the default page template; assign an existing template afterwards with edit_entities on templateSuffix."
        }
      }
    },
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

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.

Argument	Type	Description
draft*	string	The draft’s fudge://project/… ref.
store	string	The connected store to use. Omit when only one is connected.
product*	object

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "product"
  ],
  "properties": {
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "product": {
      "type": "object",
      "required": [
        "title"
      ],
      "properties": {
        "seo": {
          "type": "object",
          "properties": {
            "title": {
              "type": "string"
            },
            "description": {
              "type": "string"
            }
          }
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "files": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "alt": {
                "type": "string"
              }
            }
          },
          "description": "Existing Shopify file GIDs (e.g. from media uploads) to attach as product media."
        },
        "title": {
          "type": "string",
          "minLength": 1
        },
        "handle": {
          "type": "string",
          "description": "URL handle; derived from the title when omitted."
        },
        "vendor": {
          "type": "string"
        },
        "options": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "name",
              "values"
            ],
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1
              },
              "values": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "minItems": 1
              }
            }
          },
          "maxItems": 3,
          "description": "Product options (max 3), e.g. [{name: \"Size\", values: [\"S\", \"M\"]}]. Omit for a single-variant product."
        },
        "category": {
          "type": "string",
          "description": "Shopify taxonomy category GID (browse `.taxonomy`)."
        },
        "giftCard": {
          "type": "boolean",
          "description": "Gift-card product — set only at creation, immutable afterwards."
        },
        "variants": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "options"
            ],
            "properties": {
              "sku": {
                "type": "string"
              },
              "price": {
                "type": "string",
                "description": "Decimal string in the shop currency, e.g. \"19.99\"."
              },
              "barcode": {
                "type": "string"
              },
              "options": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1,
                "description": "One value per product option, in the same order as `options` (e.g. [\"S\", \"Black\"])."
              },
              "compareAtPrice": {
                "type": "string"
              }
            }
          },
          "maxItems": 100
        },
        "collections": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Collection ids/GIDs the product joins (manual membership)."
        },
        "productType": {
          "type": "string"
        },
        "templateSuffix": {
          "type": "string"
        },
        "descriptionHtml": {
          "type": "string"
        }
      }
    }
  }
}

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.

Argument	Type	Description
areas*	array	Areas the Plan serves; empty for store-wide work.
brief	string	Markdown brief: goal, audience, decisions and constraints. Saved as brief.md in the Plan.
store	string	The connected store to use. Omit when only one is connected.
title*	string	Short outcome-focused title, e.g. “Rank for trail running shoes”.
milestones*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "title",
    "areas",
    "milestones"
  ],
  "properties": {
    "areas": {
      "type": "array",
      "items": {
        "enum": [
          "seo",
          "ai-discovery",
          "conversion",
          "merchandising",
          "landing-pages",
          "blog",
          "products",
          "quizzes",
          "popups",
          "discounts",
          "storefront"
        ],
        "type": "string"
      },
      "maxItems": 4,
      "description": "Areas the Plan serves; empty for store-wide work."
    },
    "brief": {
      "type": "string",
      "maxLength": 20000,
      "description": "Markdown brief: goal, audience, decisions and constraints. Saved as brief.md in the Plan."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "title": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Short outcome-focused title, e.g. “Rank for trail running shoes”."
    },
    "milestones": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "note": {
            "type": "string",
            "maxLength": 240,
            "description": "One merchant-facing line on the intended outcome."
          },
          "title": {
            "type": "string",
            "maxLength": 160,
            "minLength": 1
          }
        }
      },
      "maxItems": 20,
      "minItems": 1
    }
  }
}

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.

destructive

Argument	Type	Description
path*	string	Destination path, for example .plans/<slug>/brief.md.
store	string	The connected store to use. Omit when only one is connected.
content*	string	Complete document content.
replace	boolean	True to replace an existing document you have read in full.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "path",
    "content"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "Destination path, for example .plans/<slug>/brief.md."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "content": {
      "type": "string",
      "description": "Complete document content."
    },
    "replace": {
      "type": "boolean",
      "description": "True to replace an existing document you have read in full."
    }
  }
}

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.

destructive

Argument	Type	Description
path*	string	A theme file such as sections/main-product.liquid or templates/product.json, or a content document such as .entities/product/123.jsonc or .entities/page/45.body.html.
draft*	string	The draft’s fudge://project/… ref.
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "A theme file such as sections/main-product.liquid or templates/product.json, or a content document such as .entities/product/123.jsonc or .entities/page/45.body.html."
    },
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

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" (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.

destructive

Argument	Type	Description
draft*	string	The draft’s fudge://project/… ref.
edits*	array
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "edits"
  ],
  "properties": {
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "edits": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "file",
          "patch"
        ],
        "properties": {
          "file": {
            "type": "string",
            "description": "An .entities doc or patch-facet path, e.g. \".entities/product/123\", \".entities/product/123/variants.jsonc\", or \".entities/product/123.metafields\""
          },
          "patch": {
            "type": "object",
            "description": "Sparse JSON object using the document’s field names and value shapes. Arbitrary keys and nested JSON values are allowed; omitted fields stay unchanged.",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          }
        }
      },
      "minItems": 1
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

edit_draft_file

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

destructive

Argument	Type	Description
path*	string	A theme file such as sections/main-product.liquid or templates/product.json, or a content document such as .entities/product/123.jsonc or .entities/page/45.body.html.
draft*	string	The draft’s fudge://project/… ref.
edits*	array
store	string	The connected store to use. Omit when only one is connected.
revision	string	The revision returned when this file was read.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "path",
    "edits"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "A theme file such as sections/main-product.liquid or templates/product.json, or a content document such as .entities/product/123.jsonc or .entities/page/45.body.html."
    },
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "edits": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "old_string",
          "new_string"
        ],
        "properties": {
          "new_string": {
            "type": "string",
            "description": "Replacement text; empty deletes old_string."
          },
          "old_string": {
            "type": "string",
            "minLength": 1,
            "description": "Exact text to replace."
          },
          "replace_all": {
            "type": "boolean",
            "description": "Replace every occurrence. Defaults to false."
          }
        }
      },
      "maxItems": 50,
      "minItems": 1
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "revision": {
      "type": "string",
      "maxLength": 64,
      "description": "The revision returned when this file was read."
    }
  }
}

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.

destructive

Argument	Type	Description
path*	string	Path of the existing document.
store	string	The connected store to use. Omit when only one is connected.
new_string*	string	Replacement text; empty deletes old_string.
old_string*	string	Exact text to replace.
replace_all	boolean	Replace every occurrence. Defaults to false.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "path",
    "old_string",
    "new_string"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "Path of the existing document."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "new_string": {
      "type": "string",
      "description": "Replacement text; empty deletes old_string."
    },
    "old_string": {
      "type": "string",
      "minLength": 1,
      "description": "Exact text to replace."
    },
    "replace_all": {
      "type": "boolean",
      "description": "Replace every occurrence. Defaults to false."
    }
  }
}

find_context

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.

read-only

Argument	Type	Description
about	string	ID, storefront URL/path or file that results must relate to.
query	string
store	string	The connected store to use. Omit when only one is connected.
where	object
cursor	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "about": {
      "type": "string",
      "description": "ID, storefront URL/path or file that results must relate to."
    },
    "query": {
      "type": "string"
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "where": {
      "type": "object",
      "properties": {
        "kind": {
          "enum": [
            "document",
            "plan",
            "project",
            "finding",
            "proposal",
            "conversation",
            "report",
            "skill",
            "change"
          ],
          "type": "string"
        },
        "plan": {
          "type": "string"
        },
        "time": {
          "type": "object",
          "required": [
            "field"
          ],
          "properties": {
            "to": {
              "type": "string"
            },
            "from": {
              "type": "string"
            },
            "field": {
              "enum": [
                "created",
                "updated",
                "activity",
                "edited",
                "published"
              ],
              "type": "string"
            }
          }
        },
        "edited": {
          "type": "string",
          "description": "File or entity directly edited; kind project or conversation."
        },
        "status": {
          "type": "string"
        },
        "project": {
          "type": "string"
        }
      }
    },
    "cursor": {
      "type": "string"
    }
  }
}

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.

read-only

Argument	Type	Description
seed*	string
limit	integer
store	string	The connected store to use. Omit when only one is connected.
language	string	Language code, e.g. "en". Defaults to the store’s language.
location*	string	Target country, e.g. "United States". Ask the merchant which countries they sell to if unknown.
minVolume	integer
maxDifficulty	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "location",
    "seed"
  ],
  "properties": {
    "seed": {
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "language": {
      "type": "string",
      "description": "Language code, e.g. \"en\". Defaults to the store’s language."
    },
    "location": {
      "type": "string",
      "minLength": 1,
      "description": "Target country, e.g. \"United States\". Ask the merchant which countries they sell to if unknown."
    },
    "minVolume": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "maxDifficulty": {
      "type": "number",
      "maximum": 100,
      "minimum": 0
    }
  }
}

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.

Argument	Type	Description
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

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.

read-only

Argument	Type	Description
store	string	The connected store to use. Omit when only one is connected.
keywords*	array
language	string	Language code, e.g. "en". Defaults to the store’s language.
location*	string	Target country, e.g. "United States". Ask the merchant which countries they sell to if unknown.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "location",
    "keywords"
  ],
  "properties": {
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 50,
      "minItems": 1
    },
    "language": {
      "type": "string",
      "description": "Language code, e.g. \"en\". Defaults to the store’s language."
    },
    "location": {
      "type": "string",
      "minLength": 1,
      "description": "Target country, e.g. \"United States\". Ask the merchant which countries they sell to if unknown."
    }
  }
}

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 a daily limit.

read-only

Argument	Type	Description
limit	integer
store	string	The connected store to use. Omit when only one is connected.
domain	string	Defaults to this store’s domain.
language	string	Language code, e.g. "en". Defaults to the store’s language.
location*	string	Target country, e.g. "United States". Ask the merchant which countries they sell to if unknown.
pathPrefix	string	Only URLs under this path, e.g. /blogs/.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "location"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "domain": {
      "type": "string",
      "description": "Defaults to this store’s domain."
    },
    "language": {
      "type": "string",
      "description": "Language code, e.g. \"en\". Defaults to the store’s language."
    },
    "location": {
      "type": "string",
      "minLength": 1,
      "description": "Target country, e.g. \"United States\". Ask the merchant which countries they sell to if unknown."
    },
    "pathPrefix": {
      "type": "string",
      "pattern": "^\\/.*",
      "description": "Only URLs under this path, e.g. /blogs/."
    }
  }
}

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.

read-only

Argument	Type	Description
store	string	The connected store to use. Omit when only one is connected.
device	string
keyword*	string
language	string	Language code, e.g. "en". Defaults to the store’s language.
location*	string	Target country, e.g. "United States". Ask the merchant which countries they sell to if unknown.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "location",
    "keyword"
  ],
  "properties": {
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "device": {
      "enum": [
        "desktop",
        "mobile"
      ],
      "type": "string",
      "default": "mobile"
    },
    "keyword": {
      "type": "string",
      "minLength": 1
    },
    "language": {
      "type": "string",
      "description": "Language code, e.g. \"en\". Defaults to the store’s language."
    },
    "location": {
      "type": "string",
      "minLength": 1,
      "description": "Target country, e.g. \"United States\". Ask the merchant which countries they sell to if unknown."
    }
  }
}

get_store_audit_result

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-only

Argument	Type	Description
audit*	string	The diagnostic’s id.
store	string	The connected store to use. Omit when only one is connected.
domain	string	The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.
waitSeconds	integer	Default 0.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "audit"
  ],
  "properties": {
    "audit": {
      "enum": [
        "ai-readiness",
        "catalog-audit",
        "knowledge-base"
      ],
      "type": "string",
      "description": "The diagnostic’s id."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "domain": {
      "type": "string",
      "description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store."
    },
    "waitSeconds": {
      "type": "integer",
      "maximum": 50,
      "minimum": 0,
      "description": "Default 0."
    }
  }
}

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 saved yet. This never starts an investigation.

read-only

Argument	Type	Description
ref	string	Read one record in full; the other filters are ignored.
area	string	seo, ai-discovery, conversion or merchandising, or a library such as landing-pages or quizzes.
kind	string
limit	integer
query	string	Words to find in the title, summary or body.
since	string	Only records created or updated on or after this date.
store	string	The connected store to use. Omit when only one is connected.
subject	string	A product, collection, page or article ID (product-42 or a Shopify GID), or a Fudge Plan ref.

Input schema (JSON)

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. Use for a brief or before planning work.

read-only

Argument	Type	Description
area	string	seo, ai-discovery, conversion or merchandising, or a library such as landing-pages or blog.
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "area": {
      "enum": [
        "seo",
        "ai-discovery",
        "conversion",
        "merchandising",
        "landing-pages",
        "blog",
        "products",
        "quizzes",
        "popups",
        "discounts",
        "storefront"
      ],
      "type": "string",
      "description": "seo, ai-discovery, conversion or merchandising, or a library such as landing-pages or blog."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

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, 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.

read-only

Argument	Type	Description
days	any
sort	string	Breakdown metric to rank by, e.g. clicks, impressions, sessions, revenue, orders.
limit	integer
store	string	The connected store to use. Omit when only one is connected.
device	string
offset	integer
compare	boolean
country	string	Search Console three-letter country code, e.g. usa.

list_offers

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

read-only

Argument	Type	Description
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

list_store_audits

List the audits Fudge can run for this store, three diagnostics and eight agent reviews, with any existing result. Listing starts nothing.

read-only

Argument	Type	Description
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

list_stores

List the Shopify stores this connection can use.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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-only

Argument	Type	Description
kind	string
view	string
limit	number	1–50, default 20.
query	string	Ranked search; cannot be combined with before.
store	string	The connected store to use. Omit when only one is connected.
before	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "kind": {
      "enum": [
        "chat",
        "draft",
        "published"
      ],
      "type": "string"
    },
    "view": {
      "enum": [
        "all",
        "needs_you"
      ],
      "type": "string"
    },
    "limit": {
      "type": "number",
      "description": "1–50, default 20."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Ranked search; cannot be combined with before."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "before": {
      "type": "string"
    }
  }
}

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. `requestId` makes retries deliver once. Publishing always needs the merchant’s own approval in Fudge.

Argument	Type	Description
ref	string	fudge://thread/… or fudge://project/… to continue; omit to start new work.
store	string	The connected store to use. Omit when only one is connected.
title	string	Short title for a new conversation.
message*	string	The merchant’s request in full: what to do, for which page or products, and any decisions already made.
delivery	string
requestId*	string	A unique ID you choose for this request, e.g. a UUID. Retries reuse it.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "message",
    "requestId"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "fudge://thread/… or fudge://project/… to continue; omit to start new work."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "title": {
      "type": "string",
      "maxLength": 80,
      "description": "Short title for a new conversation."
    },
    "message": {
      "type": "string",
      "maxLength": 20000,
      "minLength": 1,
      "description": "The merchant’s request in full: what to do, for which page or products, and any decisions already made."
    },
    "delivery": {
      "enum": [
        "steer",
        "queue"
      ],
      "type": "string",
      "default": "steer"
    },
    "requestId": {
      "type": "string",
      "maxLength": 100,
      "minLength": 8,
      "description": "A unique ID you choose for this request, e.g. a UUID. Retries reuse it."
    }
  }
}

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.

read-only

Argument	Type	Description
store	string	The connected store to use. Defaults to the first one.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "store": {
      "type": "string",
      "description": "The connected store to use. Defaults to the first 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=…). Lines are numbered; long files return `line_offset`. Theme files return a `revision`. Append #info to see where a theme file is used.

read-only

Argument	Type	Description
path*	string	A theme file such as sections/main-product.liquid or templates/product.json, or a content document such as .entities/product/123.jsonc or .entities/page/45.body.html.
draft*	string	The draft’s fudge://project/… ref.
store	string	The connected store to use. Omit when only one is connected.
line_limit	integer	Lines to return. Omit to read up to the limit.
char_offset	integer	Character offset within a very long first line, only when the result says to continue with one.
line_offset	integer	0-based line to start from, from a previous read.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "A theme file such as sections/main-product.liquid or templates/product.json, or a content document such as .entities/product/123.jsonc or .entities/page/45.body.html."
    },
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "line_limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Lines to return. Omit to read up to the limit."
    },
    "char_offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Character offset within a very long first line, only when the result says to continue with one."
    },
    "line_offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "0-based line to start from, from a previous read."
    }
  }
}

read_guide

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

read-only

Argument	Type	Description
path	string	The guide’s path.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 200,
      "description": "The guide’s path."
    }
  }
}

read_store_document

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.

read-only

Argument	Type	Description
path	string	Document or folder path, optionally with its ?query.
store	string	The connected store to use. Omit when only one is connected.
offset	integer	Character offset from a previous `next`.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "path": {
      "type": "string",
      "default": "",
      "maxLength": 2000,
      "description": "Document or folder path, optionally with its ?query."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Character offset from a previous `next`."
    }
  }
}

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:// ref): what has changed there, by `view` current, history or summary. `about: "fudge://store"` is the store-wide timeline.

read-only

Argument	Type	Description
to	string
ref	string	A work item to read: fudge://project/… or fudge://thread/….
from	string	With view history: YYYY-MM-DD in store time, or an ISO timestamp.
view	string
about	string	Storefront URL/path, Shopify GID, theme file, fudge://discount/<key>, .projects/.plans path, or fudge://store for the whole store.
store	string	The connected store to use. Omit when only one is connected.
cursor	string
waitSeconds	integer	With ref: wait up to this long for running work to finish or need the merchant. Default 0.

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.

Argument	Type	Description
at	string	When it took effect: YYYY-MM-DD or an ISO timestamp. Defaults to now.
why	string	Intent or expected effect, so results can be checked against it later.
what*	string	What changed, concretely, e.g. "Raised Meta prospecting budget from €50 to €80 a day".
links	array	fudge:// references or Shopify GIDs of what the change affected, e.g. gid://shopify/Product/123.
store	string	The connected store to use. Omit when only one is connected.
surface*	string	Where: theme, catalogue, pricing, discounts, email, Meta ads, Google ads, apps, shipping or other.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "what",
    "surface"
  ],
  "properties": {
    "at": {
      "type": "string",
      "description": "When it took effect: YYYY-MM-DD or an ISO timestamp. Defaults to now."
    },
    "why": {
      "type": "string",
      "description": "Intent or expected effect, so results can be checked against it later."
    },
    "what": {
      "type": "string",
      "minLength": 1,
      "description": "What changed, concretely, e.g. \"Raised Meta prospecting budget from €50 to €80 a day\"."
    },
    "links": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "fudge:// references or Shopify GIDs of what the change affected, e.g. gid://shopify/Product/123."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "surface": {
      "type": "string",
      "minLength": 1,
      "description": "Where: theme, catalogue, pricing, discounts, email, Meta ads, Google ads, apps, shipping or other."
    }
  }
}

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.

Argument	Type	Description
note*	string	The lasting rule, decision or learning to keep, written as it should apply in future work, with its conditions, exceptions and reason. Not a one-off task or a detail of the current draft.
store	string	The connected store to use. Omit when only one is connected.
personal	boolean	Save only for the person you are serving: how to work with them (language, tone, length, what to ask them). Default: shared with everyone working on this store. Never put a person's private details in shared memory.
replaces	boolean	The user explicitly corrected or reversed an earlier rule. Replace the old rule instead of returning a conflict.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "note"
  ],
  "properties": {
    "note": {
      "type": "string",
      "minLength": 1,
      "description": "The lasting rule, decision or learning to keep, written as it should apply in future work, with its conditions, exceptions and reason. Not a one-off task or a detail of the current draft."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "personal": {
      "type": "boolean",
      "description": "Save only for the person you are serving: how to work with them (language, tone, length, what to ask them). Default: shared with everyone working on this store. Never put a person's private details in shared memory."
    },
    "replaces": {
      "type": "boolean",
      "description": "The user explicitly corrected or reversed an earlier rule. Replace the old rule instead of returning a conflict."
    }
  }
}

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.

read-only

Argument	Type	Description
ref*	string	The work’s fudge://project/… ref.
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "The work’s fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

run_ai_readiness_check

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.

Argument	Type	Description
fresh	boolean	Start a new run even when a result from the last 24 hours exists.
store	string	The connected store to use. Omit when only one is connected.
domain	string	The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "fresh": {
      "type": "boolean",
      "description": "Start a new run even when a result from the last 24 hours exists."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "domain": {
      "type": "string",
      "description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store."
    }
  }
}

run_catalog_data_audit

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.

Argument	Type	Description
fresh	boolean	Start a new run even when a result from the last 24 hours exists.
store	string	The connected store to use. Omit when only one is connected.
domain	string	The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "fresh": {
      "type": "boolean",
      "description": "Start a new run even when a result from the last 24 hours exists."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "domain": {
      "type": "string",
      "description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store."
    }
  }
}

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 last 24 hours unless `fresh` is true.

Argument	Type	Description
fresh	boolean	Start a new run even when a result from the last 24 hours exists.
store	string	The connected store to use. Omit when only one is connected.
domain	string	The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "fresh": {
      "type": "boolean",
      "description": "Start a new run even when a result from the last 24 hours exists."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "domain": {
      "type": "string",
      "description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store."
    }
  }
}

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.

read-only

Argument	Type	Description
limit	integer
query	string	Words from the title or handle. Leave empty to list by type in title order.
store	string	The connected store to use. Omit when only one is connected.
types	array
offset	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "default": "",
      "maxLength": 200,
      "description": "Words from the title or handle. Leave empty to list by type in title order."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "product",
          "collection",
          "page",
          "article"
        ],
        "type": "string"
      },
      "default": [
        "product",
        "collection",
        "page",
        "article"
      ],
      "minItems": 1
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0
    }
  }
}

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.

read-only

Argument	Type	Description
limit	number
query*	string
scope*	string
industry	string
pageKind	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query",
    "scope"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "query": {
      "type": "string"
    },
    "scope": {
      "enum": [
        "site",
        "page",
        "pattern"
      ],
      "type": "string"
    },
    "industry": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "pageKind": {
      "enum": [
        "home",
        "product",
        "collection",
        "auxiliary"
      ],
      "type": "string"
    }
  }
}

search_draft_files

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

read-only

Argument	Type	Description
draft*	string	The draft’s fudge://project/… ref.
paths*	array	Files, folders or glob patterns, e.g. ["sections", "snippets/price.liquid"].
store	string	The connected store to use. Omit when only one is connected.
pattern	string	Regular expression (RE2 syntax: no lookarounds or backreferences) to search for in those files.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "paths"
  ],
  "properties": {
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "paths": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 500,
        "minLength": 1
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "Files, folders or glob patterns, e.g. [\"sections\", \"snippets/*price*.liquid\"]."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "pattern": {
      "type": "string",
      "maxLength": 500,
      "description": "Regular expression (RE2 syntax: no lookarounds or backreferences) to search for in those files."
    }
  }
}

search_guides

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

read-only

Argument	Type	Description
query*	string	What the merchant wants to do or know, in a few words.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "What the merchant wants to do or know, in a few words."
    }
  }
}

send_feedback

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

Argument	Type	Description
type*	string	broken: a Fudge tool failed or did the wrong thing. stuck: you couldn’t finish the task with Fudge’s tools. hard: the tools made the task much harder than it should be. missing: the task needed something Fudge’s tools can’t do. merchant: the merchant asked you to pass this on; only when they ask.
store	string	The connected store to use. Defaults to the first one.
message*	string	Up to 250 words, starting with a one-line summary. For a problem: what you did, what the tools returned and what would have made it easy. For missing: the task, what you did instead and what the tool could look like. For merchant: their words as they put them. Leave out personal details nobody asked you to send.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "message"
  ],
  "properties": {
    "type": {
      "enum": [
        "broken",
        "stuck",
        "hard",
        "missing",
        "merchant"
      ],
      "type": "string",
      "description": "broken: a Fudge tool failed or did the wrong thing. stuck: you couldn’t finish the task with Fudge’s tools. hard: the tools made the task much harder than it should be. missing: the task needed something Fudge’s tools can’t do. merchant: the merchant asked you to pass this on; only when they ask."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Defaults to the first one."
    },
    "message": {
      "type": "string",
      "description": "Up to 250 words, starting with a one-line summary. For a problem: what you did, what the tools returned and what would have made it easy. For missing: the task, what you did instead and what the tool could look like. For merchant: their words as they put them. Leave out personal details nobody asked you to send."
    }
  }
}

set_preview_consent

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

destructive

Argument	Type	Description
draft*	string	The draft’s fudge://project/… ref.
scope*	string	project: this draft only; site: every draft.
state*	string
store	string	The connected store to use. Omit when only one is connected.
answer*	string	The answer code from Fudge’s consent card.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "scope",
    "state",
    "answer"
  ],
  "properties": {
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "scope": {
      "enum": [
        "project",
        "site"
      ],
      "type": "string",
      "description": "project: this draft only; site: every draft."
    },
    "state": {
      "enum": [
        "granted",
        "declined"
      ],
      "type": "string"
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "answer": {
      "type": "string",
      "maxLength": 200,
      "description": "The answer code from Fudge’s consent card."
    }
  }
}

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.

read-only

Argument	Type	Description
references*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "references"
  ],
  "properties": {
    "references": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "ref"
        ],
        "properties": {
          "ref": {
            "type": "string"
          },
          "note": {
            "type": "string",
            "maxLength": 160
          }
        }
      },
      "maxItems": 8,
      "minItems": 1
    }
  }
}

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.

read-only

Argument	Type	Description
ref	string	A fudge://project/… ref.
store	string	The connected store to use. Defaults to the first one.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "ref": {
      "type": "string",
      "description": "A fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Defaults to the first one."
    }
  }
}

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.

read-only

Argument	Type	Description
draft*	string	The draft’s fudge://project/… ref.
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft"
  ],
  "properties": {
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

show_resources

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

read-only

Argument	Type	Description
refs*	array
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "refs"
  ],
  "properties": {
    "refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 12,
      "minItems": 1
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

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 draft. Use for precise changes you make yourself; needs a Fudge plan that includes building.

Argument	Type	Description
page	string	Storefront path the work is about, e.g. /products/blue-runner, /collections/sale or /pages/about. Anchors the preview. Defaults to the home page.
work	string	A fudge://project/… ref to continue instead of starting new work.
store	string	The connected store to use. Omit when only one is connected.
title*	string	Short merchant-facing name for the work, e.g. “Size guide on product pages”.
requestId*	string	A unique ID you choose for this request, e.g. a UUID. Retries reuse it.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "title",
    "requestId"
  ],
  "properties": {
    "page": {
      "type": "string",
      "maxLength": 2000,
      "description": "Storefront path the work is about, e.g. /products/blue-runner, /collections/sale or /pages/about. Anchors the preview. Defaults to the home page."
    },
    "work": {
      "type": "string",
      "maxLength": 200,
      "description": "A fudge://project/… ref to continue instead of starting new work."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "title": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Short merchant-facing name for the work, e.g. “Size guide on product pages”."
    },
    "requestId": {
      "type": "string",
      "maxLength": 100,
      "minLength": 8,
      "description": "A unique ID you choose for this request, e.g. a UUID. Retries reuse it."
    }
  }
}

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.

Argument	Type	Description
description*	string	The store idea: what they sell, who for, and anything they’ve said about the brand.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "description"
  ],
  "properties": {
    "description": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 12,
      "description": "The store idea: what they sell, who for, and anything they’ve said about the brand."
    }
  }
}

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.

Argument	Type	Description
domain*	string	The Shopify storefront, e.g. example.com.
instructions	string	What the merchant wants from the redesign, in their words.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "The Shopify storefront, e.g. example.com."
    },
    "instructions": {
      "type": "string",
      "maxLength": 2000,
      "description": "What the merchant wants from the redesign, in their words."
    }
  }
}

stop_work

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

destructive

Argument	Type	Description
ref*	string	The work’s fudge://thread/… or fudge://project/… ref.
runId	string
store	string	The connected store to use. Omit when only one is connected.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "The work’s fudge://thread/… or fudge://project/… ref."
    },
    "runId": {
      "type": "string"
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    }
  }
}

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 non-empty "name".

destructive

Argument	Type	Description
path*	string	A theme file such as sections/main-product.liquid or templates/product.json, or a content document such as .entities/product/123.jsonc or .entities/page/45.body.html.
draft*	string	The draft’s fudge://project/… ref.
store	string	The connected store to use. Omit when only one is connected.
content*	string	The complete file content, without line numbers.
replace	boolean	True to replace an existing file you have read in full.
revision	string	The revision returned when this file was read, when replacing.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "draft",
    "path",
    "content"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "A theme file such as sections/main-product.liquid or templates/product.json, or a content document such as .entities/product/123.jsonc or .entities/page/45.body.html."
    },
    "draft": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The draft’s fudge://project/… ref."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "content": {
      "type": "string",
      "maxLength": 400000,
      "description": "The complete file content, without line numbers."
    },
    "replace": {
      "type": "boolean",
      "description": "True to replace an existing file you have read in full."
    },
    "revision": {
      "type": "string",
      "maxLength": 64,
      "description": "The revision returned when this file was read, when replacing."
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "type": {
      "enum": [
        "product",
        "collection",
        "page",
        "article"
      ],
      "type": "string",
      "description": "List this type’s offenders instead of the summary."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "missing": {
      "type": "string",
      "description": "With type: only items missing this field, named as in the summary, e.g. \"Meta description\"."
    },
    "refresh": {
      "type": "boolean",
      "default": false,
      "description": "Rescan instead of reusing this hour’s result. Only after the merchant changed catalogue data."
    },
    "includeProductIdentifiers": {
      "type": "boolean",
      "default": false,
      "description": "Also check GTIN/barcode and MPN on products. A separate, slower scan."
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "ref": {
      "type": "string",
      "pattern": "^fudge:\\/\\/(finding|proposal)\\/[\\w-]+$",
      "description": "Read one record in full; the other filters are ignored."
    },
    "area": {
      "enum": [
        "seo",
        "ai-discovery",
        "conversion",
        "merchandising",
        "landing-pages",
        "blog",
        "products",
        "quizzes",
        "popups",
        "discounts",
        "storefront"
      ],
      "type": "string",
      "description": "seo, ai-discovery, conversion or merchandising, or a library such as landing-pages or quizzes."
    },
    "kind": {
      "enum": [
        "finding",
        "recommendation"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Words to find in the title, summary or body."
    },
    "since": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      "description": "Only records created or updated on or after this date."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "subject": {
      "type": "string",
      "description": "A product, collection, page or article ID (product-42 or a Shopify GID), or a Fudge Plan ref."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "days": {
      "anyOf": [
        {
          "type": "number",
          "const": 7
        },
        {
          "type": "number",
          "const": 28
        },
        {
          "type": "number",
          "const": 90
        }
      ],
      "default": 28
    },
    "sort": {
      "enum": [
        "views",
        "visitors",
        "newVisitors",
        "returningVisitors",
        "averageEngagementTime",
        "sessions",
        "engagedSessions",
        "engagementRate",
        "purchases",
        "purchaseRate",
        "revenue",
        "addToCarts",
        "checkouts",
        "clicks",
        "impressions",
        "ctr",
        "position",
        "orders",
        "orderRevenue",
        "discounts",
        "refunds",
        "aov",
        "units",
        "unitsSold",
        "productSales",
        "stock",
        "firstOrders",
        "repeatOrders"
      ],
      "type": "string",
      "description": "Breakdown metric to rank by, e.g. clicks, impressions, sessions, revenue, orders."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "device": {
      "enum": [
        "all",
        "mobile",
        "desktop",
        "tablet"
      ],
      "type": "string",
      "default": "all"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "compare": {
      "type": "boolean",
      "default": true
    },
    "country": {
      "type": "string",
      "pattern": "^[a-zA-Z]{3}$",
      "description": "Search Console three-letter country code, e.g. usa."
    },
    "endDate": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "metrics": {
      "type": "array",
      "items": {
        "enum": [
          "page_views",
          "visitors",
          "sessions",
          "engagement_rate",
          "add_to_carts",
          "purchases",
          "purchase_revenue",
          "purchase_rate",
          "ai_referral_sessions",
          "organic_search_sessions",
          "search_clicks",
          "search_impressions",
          "search_ctr",
          "search_position",
          "units_sold",
          "product_sales",
          "orders",
          "order_revenue",
          "average_order_value"
        ],
        "type": "string"
      },
      "maxItems": 8,
      "minItems": 1
    },
    "subject": {
      "type": "string",
      "maxLength": 2000,
      "description": "What to measure: a product, collection, page or article ID (product-42 or a Shopify GID), its name or handle, a storefront URL or path (/products/x), or omit for the whole store."
    },
    "ascending": {
      "type": "boolean",
      "default": false
    },
    "breakdown": {
      "enum": [
        "search_queries",
        "search_pages",
        "search_devices",
        "search_countries",
        "landing_pages",
        "page_views",
        "channels",
        "ai_assistants",
        "ai_landing_pages",
        "devices",
        "countries",
        "campaigns",
        "products",
        "discount_codes"
      ],
      "type": "string"
    },
    "startDate": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "comparisonEnd": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "comparisonStart": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "to": {
      "type": "string"
    },
    "ref": {
      "type": "string",
      "description": "A work item to read: fudge://project/… or fudge://thread/…."
    },
    "from": {
      "type": "string",
      "description": "With view history: YYYY-MM-DD in store time, or an ISO timestamp."
    },
    "view": {
      "enum": [
        "current",
        "history",
        "summary"
      ],
      "type": "string"
    },
    "about": {
      "type": "string",
      "description": "Storefront URL/path, Shopify GID, theme file, fudge://discount/<key>, .projects/.plans path, or fudge://store for the whole store."
    },
    "store": {
      "type": "string",
      "description": "The connected store to use. Omit when only one is connected."
    },
    "cursor": {
      "type": "string"
    },
    "waitSeconds": {
      "type": "integer",
      "maximum": 50,
      "minimum": 0,
      "description": "With ref: wait up to this long for running work to finish or need the merchant. Default 0."
    }
  }
}

Fudge for Shopify

Registry entry

Try it

capture_page Read-only

Fudge for Shopify

Registry entry

Try it

capture_page Read-only

Install

Tools (57)

Security checkA100/100