Server definition
- Hash
- sha256:b64590e36f78d10595ade3dc1932e34cb9cb441225e7bdf3ab10900aff1a8bd2
- What it is
- What a remote MCP server returned when asked what it offers: 68 tools
The blob, as servednamed by its sha256
{
"instructions": "Fudge is a growth team for Shopify stores. It keeps each store's priorities, Plans, work, findings and measurements. Read them before advising; never guess store facts.\nBefore a store is connected, design references, page checks, free reports and free SEO audits work: pass the storefront's domain.\nWhen the merchant has just connected Fudge or asks how to start, call list_stores, then open_fudge_home, lead with what needs them, offer a regular brief if this assistant can schedule tasks, and suggest one first job.\nStart a brief or plan with get_store_overview and follow the preferences in its memory. With several stores, ask which one and pass `store`; never guess. Call read_work before describing work's state, and read_store_activity before building; build on what is there.\nState each number's period and source. Google Analytics, Search Console and Shopify are separate measurements: never add them together.\nShow Fudge items with show_resources and Lookbook references with show_design_references. They appear above your reply, so keep it short and don't repeat them.\nAsk Fudge to build with message_fudge, or make a precise change yourself with start_draft and the draft tools, then check it with capture_page. Draft edits stay private; the create_draft tools add hidden items to the store at once, so use them only when asked.\nOnly the merchant can publish, in Fudge: call request_publish_review when a draft is ready, and never say something is live until read_work shows it.\nSave lasting decisions with remember and search past work with find_context.\nFudge's guides are reference articles for each kind of work, such as seo/index.md, seo/ai-search.md, conversion/index.md, merchandising/index.md and storefront/design.md. Find them with search_guides, open them with read_guide and adapt them to the store. A guide's file_view, file_edit and file_create are read_draft_file, edit_draft_file and write_draft_file.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"device": {
"default": "both",
"enum": [
"desktop",
"mobile",
"both"
],
"type": "string"
},
"draft": {
"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.",
"maxLength": 200,
"type": "string"
},
"fullPage": {
"default": false,
"type": "boolean"
},
"page": {
"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.",
"maxLength": 2000,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "capture_page",
"outputSchema": null
},
{
"description": "Asks the public ChatGPT, Google AI Mode and Gemini apps 18 shopping questions written from a Shopify store’s catalogue in its market’s language, plus what the store is known for and, on ChatGPT, its returns and free shipping. Reports an AI visibility score; how often each assistant names the store, cites its pages or shows its products, by product line; who the answers name most often and which sources they cite; how AI describes the store; and whether ChatGPT states its return window and free-shipping threshold correctly. Real app answers, signed out, not model APIs. Free, no sign-in; waits up to 45 seconds, the first answers arrive within a minute and the rest within about 5. Shared per store for a day; unmeasured items are reported as unknown.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"country": {
"description": "The market to check, as a two-letter ISO country code such as GB. Omit it for the store’s main market.",
"type": "string"
},
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "check_ai_visibility",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"includeProductIdentifiers": {
"default": false,
"description": "Also check GTIN/barcode and MPN on products. A separate, slower scan.",
"type": "boolean"
},
"limit": {
"default": 25,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"missing": {
"description": "With type: only items missing this field, named as in the summary, e.g. \"Meta description\".",
"type": "string"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"refresh": {
"default": false,
"description": "Rescan instead of reusing this hour’s result. Only after the merchant changed catalogue data.",
"type": "boolean"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"type": {
"description": "List this type’s offenders instead of the summary.",
"enum": [
"product",
"collection",
"page",
"article"
],
"type": "string"
}
},
"type": "object"
},
"name": "check_catalog_data",
"outputSchema": null
},
{
"description": "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 word count.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"page": {
"default": "/",
"description": "A store URL or path, e.g. / or /products/blue-runner.",
"maxLength": 2000,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "check_page",
"outputSchema": null
},
{
"description": "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, render-blocking requests, third parties, layout-shift culprits). Each device takes 10–30 seconds; results are cached for an hour. On a password-protected store, only real-visitor data is available.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"device": {
"default": "both",
"enum": [
"mobile",
"desktop",
"both"
],
"type": "string"
},
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"page": {
"default": "/",
"description": "A store URL or path, e.g. / or /products/blue-runner.",
"maxLength": 2000,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "check_page_speed",
"outputSchema": null
},
{
"description": "Checks up to 12 of a Shopify store’s product pages, spread over product types, sale and stock, against Google’s merchant listing and product rich result rules, using Google’s Required, Recommended and Agreement levels and wording. It compares each page’s markup with Shopify’s own product data and Shopify Catalog, checks the product list for missing descriptions, images, brands, categories and buyer details and whether Shopify Catalog searches find the right products, and, when the markup lacks the store’s policies, returns a paste-ready return and shipping policy JSON-LD block built only from its own policy pages, saying where in the theme it goes. Free, no sign-in; waits up to 45 seconds of a run’s usual 2–4 minutes. Shared per store for an hour. Anything it could not check is reported as unknown.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "check_product_schema",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "check_store_technical",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"type": "object"
},
"name": "connect_store",
"outputSchema": null
},
{
"description": "Create a new blog article in a Fudge draft. It can be previewed in the draft and goes live when the merchant publishes.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"article": {
"properties": {
"blogId": {
"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.",
"type": "string"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"required": [
"title",
"blogId"
],
"type": "object"
},
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"article"
],
"type": "object"
},
"name": "create_draft_article",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"collection": {
"properties": {
"conditions": {
"description": "Smart-collection rules, e.g. [{field: \"tag\", relation: \"TAGGED_WITH\", values: [\"sale\"]}]. Omit for a manual collection.",
"items": {
"additionalProperties": false,
"properties": {
"definition": {
"description": "metafield conditions only: the metafield definition as \"namespace.key\".",
"type": "string"
},
"field": {
"enum": [
"tag",
"title",
"type",
"vendor",
"category",
"status",
"variantTitle",
"price",
"compareAtPrice",
"weight",
"inventory",
"metafield",
"unsupported"
],
"type": "string"
},
"id": {
"type": "string"
},
"matchType": {
"description": "For multi-value conditions: match any or all values.",
"enum": [
"ANY",
"ALL"
],
"type": "string"
},
"relation": {
"type": "string"
},
"values": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"field",
"relation",
"values"
],
"type": "object"
},
"type": "array"
},
"descriptionHtml": {
"type": "string"
},
"handle": {
"description": "URL handle; derived from the title when omitted.",
"type": "string"
},
"matchType": {
"description": "Whether products must match any or all conditions.",
"enum": [
"ANY",
"ALL"
],
"type": "string"
},
"products": {
"description": "Product ids to include manually.",
"items": {
"type": "string"
},
"type": "array"
},
"sortOrder": {
"enum": [
"ALPHA_ASC",
"ALPHA_DESC",
"BEST_SELLING",
"CREATED",
"CREATED_DESC",
"MANUAL",
"MOST_RELEVANT",
"PRICE_ASC",
"PRICE_DESC"
],
"type": "string"
},
"templateSuffix": {
"type": "string"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"required": [
"title"
],
"type": "object"
},
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"collection"
],
"type": "object"
},
"name": "create_draft_collection",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"page": {
"properties": {
"createCustomTemplate": {
"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.",
"type": "boolean"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"required": [
"title"
],
"type": "object"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"page"
],
"type": "object"
},
"name": "create_draft_page",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"product": {
"properties": {
"category": {
"description": "Shopify taxonomy category GID (browse `.taxonomy`).",
"type": "string"
},
"collections": {
"description": "Collection ids/GIDs the product joins (manual membership).",
"items": {
"type": "string"
},
"type": "array"
},
"descriptionHtml": {
"type": "string"
},
"files": {
"description": "Existing Shopify file GIDs (e.g. from media uploads) to attach as product media.",
"items": {
"properties": {
"alt": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"type": "array"
},
"giftCard": {
"description": "Gift-card product — set only at creation, immutable afterwards.",
"type": "boolean"
},
"handle": {
"description": "URL handle; derived from the title when omitted.",
"type": "string"
},
"options": {
"description": "Product options (max 3), e.g. [{name: \"Size\", values: [\"S\", \"M\"]}]. Omit for a single-variant product.",
"items": {
"properties": {
"name": {
"minLength": 1,
"type": "string"
},
"values": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"name",
"values"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"productType": {
"type": "string"
},
"seo": {
"properties": {
"description": {
"type": "string"
},
"title": {
"type": "string"
}
},
"type": "object"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"templateSuffix": {
"type": "string"
},
"title": {
"minLength": 1,
"type": "string"
},
"variants": {
"items": {
"properties": {
"barcode": {
"type": "string"
},
"barcodes": {
"description": "Complete barcode list in its existing order. Preserve other entries when editing; [] clears all. Never invent identifiers.",
"items": {
"additionalProperties": false,
"properties": {
"type": {
"description": "Use the merchant or supplier’s declared type; never infer it.",
"enum": [
"ASIN",
"EAN",
"GTIN",
"ISBN",
"NS_PID",
"UPC"
],
"type": "string"
},
"value": {
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"compareAtPrice": {
"type": "string"
},
"options": {
"description": "One value per product option, in the same order as `options` (e.g. [\"S\", \"Black\"]).",
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"price": {
"description": "Decimal string in the shop currency, e.g. \"19.99\".",
"type": "string"
},
"sku": {
"type": "string"
}
},
"required": [
"options"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"vendor": {
"type": "string"
}
},
"required": [
"title"
],
"type": "object"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"product"
],
"type": "object"
},
"name": "create_draft_product",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"areas": {
"description": "Areas the Plan serves; empty for store-wide work.",
"items": {
"enum": [
"seo",
"ai-discovery",
"conversion",
"merchandising",
"landing-pages",
"blog",
"products",
"quizzes",
"popups",
"discounts",
"storefront"
],
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"brief": {
"description": "Markdown brief: goal, audience, decisions and constraints. Saved as brief.md in the Plan.",
"maxLength": 20000,
"type": "string"
},
"milestones": {
"items": {
"properties": {
"note": {
"description": "One merchant-facing line on the intended outcome.",
"maxLength": 240,
"type": "string"
},
"title": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"title"
],
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"title": {
"description": "Short outcome-focused title, e.g. “Rank for trail running shoes”.",
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"title",
"areas",
"milestones"
],
"type": "object"
},
"name": "create_plan",
"outputSchema": null
},
{
"description": "Create a document inside an existing Plan, such as .plans/<slug>/brief.md, or with `replace` rewrite a whole document that was just read.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"content": {
"description": "Complete document content.",
"type": "string"
},
"path": {
"description": "Destination path, for example .plans/<slug>/brief.md.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"replace": {
"description": "True to replace an existing document you have read in full.",
"type": "boolean"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"path",
"content"
],
"type": "object"
},
"name": "create_store_document",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"path": {
"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.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"path"
],
"type": "object"
},
"name": "delete_draft_file",
"outputSchema": null
},
{
"description": "Change products, collections, pages, articles, blogs and their metafields in a Fudge draft with sparse patches, many items in one call.\n- Name only the fields you change; nested objects such as seo merge per key.\n- 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.\n- Lists such as tags take a full array or {\"add\": […], \"remove\": […]}.\n- Metafields: .entities/product/{id}.metafields with {\"namespace.key\": {\"type\": …, \"value\": …}}; \"value\": null removes one.\nChanges to existing items are staged for the merchant’s review. Items the draft created change in Shopify at once.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"edits": {
"items": {
"properties": {
"file": {
"description": "An .entities doc or patch-facet path, e.g. \".entities/product/123\", \".entities/product/123/variants.jsonc\", or \".entities/product/123.metafields\"",
"type": "string"
},
"patch": {
"additionalProperties": {},
"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"
},
"type": "object"
}
},
"required": [
"file",
"patch"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"edits"
],
"type": "object"
},
"name": "edit_draft_content",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"edits": {
"items": {
"properties": {
"new_string": {
"description": "Replacement text; empty deletes old_string.",
"type": "string"
},
"old_string": {
"description": "Exact text to replace.",
"minLength": 1,
"type": "string"
},
"replace_all": {
"description": "Replace every occurrence. Defaults to false.",
"type": "boolean"
}
},
"required": [
"old_string",
"new_string"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"path": {
"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.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"revision": {
"description": "The revision returned when this file was read.",
"maxLength": 64,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"path",
"edits"
],
"type": "object"
},
"name": "edit_draft_file",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"new_string": {
"description": "Replacement text; empty deletes old_string.",
"type": "string"
},
"old_string": {
"description": "Exact text to replace.",
"minLength": 1,
"type": "string"
},
"path": {
"description": "Path of the existing document.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"replace_all": {
"description": "Replace every occurrence. Defaults to false.",
"type": "boolean"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"path",
"old_string",
"new_string"
],
"type": "object"
},
"name": "edit_store_document",
"outputSchema": null
},
{
"description": "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 everything related to one thing. Conversation results say whether the work is a draft, was published or was only discussed.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"about": {
"description": "ID, storefront URL/path or file that results must relate to.",
"type": "string"
},
"cursor": {
"type": "string"
},
"query": {
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"where": {
"properties": {
"edited": {
"description": "File or entity directly edited; kind project or conversation.",
"type": "string"
},
"kind": {
"enum": [
"document",
"plan",
"project",
"finding",
"proposal",
"conversation",
"report",
"skill",
"change",
"message"
],
"type": "string"
},
"plan": {
"type": "string"
},
"project": {
"type": "string"
},
"status": {
"type": "string"
},
"time": {
"properties": {
"field": {
"enum": [
"created",
"updated",
"activity",
"edited",
"published"
],
"type": "string"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"field"
],
"type": "object"
}
},
"type": "object"
}
},
"type": "object"
},
"name": "find_context",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"language": {
"description": "Language code, e.g. \"en\". Defaults to the store’s language.",
"type": "string"
},
"limit": {
"default": 25,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"location": {
"description": "Target country, e.g. \"United States\". Ask the merchant which countries they sell to if unknown.",
"minLength": 1,
"type": "string"
},
"maxDifficulty": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"minVolume": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"seed": {
"minLength": 1,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"location",
"seed"
],
"type": "object"
},
"name": "find_keyword_ideas",
"outputSchema": null
},
{
"description": "Builds the Google searches for what a Shopify store sells from its catalogue (each kind of product with its attributes and audiences), keeps those a model judges are for its products, and checks the largest it has no collection for on Google today. Returns the missing pages worth building, with monthly searches and who ranks, and collections Google doesn’t show for searches they cover. Uses DataForSEO Google data and the store’s public catalogue. Free, no sign-in; waits up to 45 seconds of a run’s usual 1–4 minutes. Shared per store for 7 days. Anything it could not judge is reported as unknown, never as a finding.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"country": {
"description": "The market to check, as a two-letter ISO country code such as GB. Omit it for the store’s main market.",
"type": "string"
},
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "find_missing_pages",
"outputSchema": null
},
{
"description": "Finds a Shopify store’s collections, pages and articles that rank #4–20 on Google in the store’s market (DataForSEO rankings), checks the most valuable on Google today, and gives each one’s searches, monthly volumes, a range of extra clicks from reaching #3 and the change it needs, plus pages that were near page one and have left the top 20, with the cause found. One rewritten title is previewed as a Google result. Free, no sign-in; waits up to 45 seconds of a run’s usual 1–4 minutes. Shared per store for 7 days; anything not measured is reported as not checked.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"country": {
"description": "The market to check, as a two-letter ISO country code such as GB. Omit it for the store’s main market.",
"type": "string"
},
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "find_page_two_pages",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "get_design_guide",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"keywords": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"language": {
"description": "Language code, e.g. \"en\". Defaults to the store’s language.",
"type": "string"
},
"location": {
"description": "Target country, e.g. \"United States\". Ask the merchant which countries they sell to if unknown.",
"minLength": 1,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"location",
"keywords"
],
"type": "object"
},
"name": "get_keyword_metrics",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain": {
"description": "Defaults to this store’s domain.",
"type": "string"
},
"language": {
"description": "Language code, e.g. \"en\". Defaults to the store’s language.",
"type": "string"
},
"limit": {
"default": 50,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"location": {
"description": "Target country, e.g. \"United States\". Ask the merchant which countries they sell to if unknown.",
"minLength": 1,
"type": "string"
},
"pathPrefix": {
"description": "Only URLs under this path, e.g. /blogs/.",
"pattern": "^\\/.*",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"location"
],
"type": "object"
},
"name": "get_ranked_keywords",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"device": {
"default": "mobile",
"enum": [
"desktop",
"mobile"
],
"type": "string"
},
"keyword": {
"minLength": 1,
"type": "string"
},
"language": {
"description": "Language code, e.g. \"en\". Defaults to the store’s language.",
"type": "string"
},
"location": {
"description": "Target country, e.g. \"United States\". Ask the merchant which countries they sell to if unknown.",
"minLength": 1,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"location",
"keyword"
],
"type": "object"
},
"name": "get_search_results",
"outputSchema": null
},
{
"description": "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. `waitSeconds` waits up to 50 seconds for a running report.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"audit": {
"description": "The diagnostic’s id.",
"enum": [
"ai-readiness",
"catalog-audit",
"knowledge-base"
],
"type": "string"
},
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"waitSeconds": {
"description": "Default 0.",
"maximum": 50,
"minimum": 0,
"type": "integer"
}
},
"required": [
"audit"
],
"type": "object"
},
"name": "get_store_audit_result",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"area": {
"description": "seo, ai-discovery, conversion or merchandising, or a library such as landing-pages or quizzes.",
"enum": [
"seo",
"ai-discovery",
"conversion",
"merchandising",
"landing-pages",
"blog",
"products",
"quizzes",
"popups",
"discounts",
"storefront"
],
"type": "string"
},
"kind": {
"enum": [
"finding",
"recommendation"
],
"type": "string"
},
"limit": {
"default": 8,
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Words to find in the title, summary or body.",
"maxLength": 200,
"type": "string"
},
"ref": {
"description": "Read one record in full; the other filters are ignored.",
"pattern": "^fudge:\\/\\/(finding|proposal)\\/[\\w-]+$",
"type": "string"
},
"since": {
"description": "Only records created or updated on or after this date.",
"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": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"subject": {
"description": "A product, collection, page or article ID (product-42 or a Shopify GID), or a Fudge Plan ref.",
"type": "string"
}
},
"type": "object"
},
"name": "get_store_insights",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"area": {
"description": "seo, ai-discovery, conversion or merchandising, or a library such as landing-pages or blog.",
"enum": [
"seo",
"ai-discovery",
"conversion",
"merchandising",
"landing-pages",
"blog",
"products",
"quizzes",
"popups",
"discounts",
"storefront"
],
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "get_store_overview",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ascending": {
"default": false,
"type": "boolean"
},
"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"
},
"compare": {
"default": true,
"type": "boolean"
},
"comparisonEnd": {
"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": "string"
},
"comparisonStart": {
"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": "string"
},
"country": {
"description": "Search Console three-letter country code, e.g. usa.",
"pattern": "^[a-zA-Z]{3}$",
"type": "string"
},
"days": {
"anyOf": [
{
"const": 7,
"type": "number"
},
{
"const": 28,
"type": "number"
},
{
"const": 90,
"type": "number"
}
],
"default": 28
},
"device": {
"default": "all",
"enum": [
"all",
"mobile",
"desktop",
"tablet"
],
"type": "string"
},
"endDate": {
"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": "string"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"metrics": {
"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,
"type": "array"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"sort": {
"description": "Breakdown metric to rank by, e.g. clicks, impressions, sessions, revenue, orders.",
"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"
},
"startDate": {
"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": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"subject": {
"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.",
"maxLength": 2000,
"type": "string"
}
},
"type": "object"
},
"name": "get_store_performance",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"audit": {
"enum": [
"report",
"ai_visibility",
"page_two",
"missing_pages",
"product_schema",
"bfcm",
"ai-readiness",
"catalog-audit",
"knowledge-base"
],
"type": "string"
},
"country": {
"description": "Two-letter ISO country code, such as GB.",
"type": "string"
},
"cursor": {
"description": "The nextCursor from the previous page; maximum 1,000 characters.",
"type": "string"
},
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"limit": {
"default": 20,
"description": "Integer from 1 to 100 runs per page.",
"type": "number"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"audit"
],
"type": "object"
},
"name": "list_audit_runs",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "list_offers",
"outputSchema": null
},
{
"description": "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 starts nothing and spends nothing.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "list_store_audits",
"outputSchema": null
},
{
"description": "List the Shopify stores this connection can use.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"type": "object"
},
"name": "list_stores",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"before": {
"type": "string"
},
"kind": {
"enum": [
"chat",
"draft",
"published"
],
"type": "string"
},
"limit": {
"description": "1–50, default 20.",
"type": "number"
},
"query": {
"description": "Ranked search; cannot be combined with before.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"view": {
"enum": [
"all",
"needs_you"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_work",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"delivery": {
"default": "steer",
"enum": [
"steer",
"queue"
],
"type": "string"
},
"message": {
"description": "The merchant’s request in full: what to do, for which page or products, and any decisions already made.",
"maxLength": 20000,
"minLength": 1,
"type": "string"
},
"ref": {
"description": "fudge://thread/… or fudge://project/… to continue; omit to start new work.",
"type": "string"
},
"requestId": {
"description": "A unique ID you choose for this request, e.g. a UUID. Retries reuse it.",
"maxLength": 100,
"minLength": 8,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"title": {
"description": "Short title for a new conversation.",
"maxLength": 80,
"type": "string"
}
},
"required": [
"message",
"requestId"
],
"type": "object"
},
"name": "message_fudge",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"store": {
"description": "The connected store to use. Defaults to the first one.",
"type": "string"
}
},
"type": "object"
},
"name": "open_fudge_home",
"outputSchema": null
},
{
"description": "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; never starts collection or spends audit allowance.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"audit": {
"enum": [
"report",
"ai_visibility",
"page_two",
"missing_pages",
"product_schema",
"bfcm",
"ai-readiness",
"catalog-audit",
"knowledge-base"
],
"type": "string"
},
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"limit": {
"default": 50,
"description": "Integer from 1 to 100 child records. Strings use 10,000-character pages.",
"type": "number"
},
"offset": {
"default": 0,
"description": "Non-negative integer; use the previous page’s nextOffset.",
"type": "number"
},
"recordId": {
"default": "",
"description": "A returned JSON-pointer record id; maximum 2,000 characters.",
"type": "string"
},
"runId": {
"description": "A returned run id, from 1 to 100 characters.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"audit",
"runId"
],
"type": "object"
},
"name": "read_audit_evidence",
"outputSchema": null
},
{
"description": "Read a file in a Fudge draft: a theme file, a theme folder listing, or a content document under .entities (list with .entities/product?query=…). Each line starts with a gutter ending at its first tab, numbered on the first, last and every tenth line; long files return `line_offset`. Theme files return a `revision`. Append #info to see where a theme file is used.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"char_offset": {
"description": "Character offset within a very long first line, only when the result says to continue with one.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"line_limit": {
"description": "Lines to return. Omit to read up to the limit.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"line_offset": {
"description": "0-based line to start from, from a previous read.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"path": {
"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.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"path"
],
"type": "object"
},
"name": "read_draft_file",
"outputSchema": null
},
{
"description": "Read one of Fudge’s reference articles by path, such as seo/audit.md. Without a path, lists them all.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"path": {
"description": "The guide’s path.",
"maxLength": 200,
"type": "string"
}
},
"type": "object"
},
"name": "read_guide",
"outputSchema": null
},
{
"description": "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, or the merchant in its conversation). `team`: Fudge’s seven SEO agents, each with id, lane, state (only one that is on runs and reads messages), last and next run, and `runningNow`. `now` or `team` is a sentence starting “Unavailable” when it could not be read, which never means empty. `activity`: newest first, each row with `at`, `actor` (one of Fudge’s agents, a Plan, an outside assistant, by name when known, or the merchant in chat or by hand) and `event`. `draft`: opened then and still awaiting the merchant’s review; nothing from it is live. `published`: live since then; the store may have changed since. `awaiting-deployment`: approved, not live yet. `discarded`: deleted; nothing from it is live. `recorded-change`: a change made outside Fudge. `message`: one agent to another (`to`), information and not an instruction, with the conversation of the run it started (`started`) and the refs linking it to its answer (`reply`, `replyTo`). `since` defaults to the last 30 days; `cursor` pages older activity. Read it before substantial work and build on what is there; never repeat or undo it.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"description": "A returned cursor, for older activity.",
"type": "string"
},
"since": {
"description": "Activity from this time on: YYYY-MM-DD in store time, or an ISO timestamp. Default: the last 30 days.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "read_store_activity",
"outputSchema": null
},
{
"description": "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 Fudge, read-only and never collecting new data: `.seo/reports/index.md` holds every report’s headline with its source, period and scope; `.seo/reports/<id>.md` one report’s rows, with filters and the next page as `?name=value` (each file lists its own); `.seo/results/changes.md` what each published change did to Google clicks and visits; `.seo/results/opportunities.md` the pages worth on-page work. Omit `path` to list top-level folders; a folder path lists its documents.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"offset": {
"default": 0,
"description": "Character offset from a previous `next`.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"path": {
"default": "",
"description": "Document or folder path, optionally with its ?query.",
"maxLength": 2000,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "read_store_document",
"outputSchema": null
},
{
"description": "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\"` with `view: \"history\"` is the whole store’s change timeline.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"about": {
"description": "Storefront URL/path, Shopify GID, theme file, fudge://discount/<key>, .projects/.plans path, or fudge://store for the whole store.",
"type": "string"
},
"cursor": {
"type": "string"
},
"from": {
"description": "With view history: YYYY-MM-DD in store time, or an ISO timestamp.",
"type": "string"
},
"ref": {
"description": "A work item to read: fudge://project/… or fudge://thread/….",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"to": {
"type": "string"
},
"view": {
"enum": [
"current",
"history",
"summary"
],
"type": "string"
},
"waitSeconds": {
"description": "With ref: wait up to this long for running work to finish or need the merchant. Default 0.",
"maximum": 50,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "read_work",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"at": {
"description": "When it took effect: YYYY-MM-DD or an ISO timestamp. Defaults to now.",
"type": "string"
},
"links": {
"description": "fudge:// references or Shopify GIDs of what the change affected, e.g. gid://shopify/Product/123.",
"items": {
"type": "string"
},
"type": "array"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"surface": {
"description": "Where: theme, catalogue, pricing, discounts, email, Meta ads, Google ads, apps, shipping or other.",
"minLength": 1,
"type": "string"
},
"what": {
"description": "What changed, concretely, e.g. \"Raised Meta prospecting budget from €50 to €80 a day\".",
"minLength": 1,
"type": "string"
},
"why": {
"description": "Intent or expected effect, so results can be checked against it later.",
"type": "string"
}
},
"required": [
"what",
"surface"
],
"type": "object"
},
"name": "record_change",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"answer": {
"anyOf": [
{
"maxLength": 500,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"description": "The merchant’s own answer, or null only if they explicitly skip."
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"answer"
],
"type": "object"
},
"name": "record_discovery_source",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"note": {
"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.",
"minLength": 1,
"type": "string"
},
"personal": {
"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.",
"type": "boolean"
},
"replaces": {
"description": "The user explicitly corrected or reversed an earlier rule. Replace the old rule instead of returning a conflict.",
"type": "boolean"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"note"
],
"type": "object"
},
"name": "remember",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ref": {
"description": "The work’s fudge://project/… ref.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"ref"
],
"type": "object"
},
"name": "request_publish_review",
"outputSchema": null
},
{
"description": "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 seconds. Reuses a running or fresh result unless `fresh` is true; an active run is always shared.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"fresh": {
"description": "Start a new run even when a result from the last 24 hours exists.",
"type": "boolean"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "run_ai_readiness_check",
"outputSchema": null
},
{
"description": "Checks a Shopify store’s Black Friday readiness in four scored parts: gift searches its products fit (real monthly Google searches and the store’s position today, in its main market or the one `country` names), who is #1 for the store’s own \"<brand> black friday\" search and whether its sale states dates, how to get the discount and what’s included, its return, shipping and delivery details, and whether its public Shopify AI answers those questions correctly. Every problem comes with evidence and a fix brief. Free, no sign-in; waits up to 45 seconds, then returns progress and report links. Anything it could not check is reported as unchecked with its reason, never scored.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"country": {
"description": "The market to check, as a two-letter ISO country code such as GB. Omit it for the store’s main market.",
"type": "string"
},
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "run_bfcm_audit",
"outputSchema": null
},
{
"description": "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 fresh result unless `fresh` is true; an active run is always shared.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"fresh": {
"description": "Start a new run even when a result from the last 24 hours exists.",
"type": "boolean"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "run_catalog_data_audit",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"fresh": {
"description": "Start a new run even when a result from the last 24 hours exists.",
"type": "boolean"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "run_knowledge_base_check",
"outputSchema": null
},
{
"description": "Run Fudge’s free SEO report on a Shopify store: a score out of 100 averaged from its page-two, missing-pages, AI-visibility and product-schema audits, which it runs together, and a short list of what to do first. It adds the store’s Google ranking counts, whether Google can read the store (robots.txt, home page title, theme files), buttons on the home page and one product page that lead nowhere, how its articles rank, real-visitor phone speed from the Chrome UX Report and one improved title previewed as a Google result. Free, no sign-in; waits up to 45 seconds, and the full report takes about 3–7 minutes. Shared per store for a day; anything not measured is reported as unknown.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"country": {
"description": "The market to check, as a two-letter ISO country code such as GB. Omit it for the store’s main market.",
"type": "string"
},
"domain": {
"description": "The Shopify storefront to check, e.g. example.com. Required until a store is connected; afterwards, omit it to use a connected store.",
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"type": "object"
},
"name": "run_seo_report",
"outputSchema": null
},
{
"description": "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 refused once it is used up. A long result comes a page at a time: pass its `nextCursor` back as `cursor` with the same id to read the next page for free, without running the lookup again.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cursor": {
"description": "A nextCursor this tool returned: reads the next page of that run, free; input is ignored",
"maxLength": 100,
"type": "string"
},
"id": {
"description": "keyword-lookup: Keyword lookup: monthly searches, difficulty and who ranks on Google for one search in one country; check-page: Check a page: one store page’s server HTML against the page checks (page head, title, canonical, noindex, structured data, image alt text, language, mixed content, text); is-indexed: Is it indexed?: whether Google has a store page in its index and why not (Google’s coverage state: crawled or discovered but not indexed, excluded, unknown), when it last crawled it, and whether Google’s chosen canonical differs from the declared one (Search Console URL Inspection); check-product: Check a product: which catalogue checks a product passes, from the last catalogue scan, and what it is when it isn’t a product sold on its own; speed-test: Speed test: a lab test of one store page on phone and desktop (Google PageSpeed Insights), with its score, load time and the biggest fixes; rich-result-test: Rich result test: which of Google’s rich results (price and stock, review stars, breadcrumbs, article, store logo) a store page’s structured data can earn, and what each lacks; set-product-kind: Set product kind: say a product, or every product of a vendor, type, tag or title start, is an add-on, service, deposit, gift card, sample, bundle, digital product or a product sold on its own; catalogue checks then count only what applies; ask-assistant: Ask an assistant: one live ChatGPT, Gemini or Google AI Mode answer to a shopper’s question, read the way tracking reads it (whether it named or linked the store, its products and sources); ai-answer-for-product: AI answer for a product: what ChatGPT, Gemini or Google AI Mode tells a shopper asking about one of the store’s products, and whether it names the store and shows that product; compare-periods: Compare two periods: one page’s Google clicks, impressions and position over the last 7, 28 or 90 days against the period before, with the searches that moved most; topic-ideas: Topic ideas: the most-searched searches containing a topic in one country, with monthly searches and difficulty; competitor-gaps: Competitor gaps: searches a competitor ranks for on Google and the store does not, most searched first; kept for the New pages list; content-brief: Content brief: for one search in one country, what Google ranks on page one, the questions and related searches it shows, its monthly searches and difficulty, and the store pages Google already shows for it; google-results: Google results for a search: the top 20 in a country or a city, with the store’s position, and the AI Overview, product listings, local pack and ads the page shows, with whether the store appears in each; redirect-check: Redirect and broken-link check: follows one store address, or the internal links on the store’s busiest pages, and lists links to missing pages (with the pages linking there and a suggested redirect) and redirect chains, loops, temporary redirects and http or host hops; internal-links: Internal link suggestions: store pages that should link to a page (pages Google shows for its searches, hub pages on its topic, weighted by visits), each with anchor text; pages already linking to it are left out; check-urls: Check a list of URLs: status and redirects, indexability (noindex, robots.txt, canonical), title, meta description, structured data and failing page checks for up to 100 store addresses, given as urls or pasted text or CSV; 25 rows a page with the whole list’s summary; title-test: Title tester: scores proposed search titles and meta descriptions for a store page against the searches it is shown for (Search Console) and the titles Google ranks on page one for its top search, with where Google cuts each off (pixel width); backlink-check: Backlink check: the sites linking to any domain or page (the store’s by default), its links, the sites gained and lost in 30 days, and the strongest linking sites; seasonal-recheck: Seasonal recheck: rerun the active season’s readiness check (gift searches, deal pages, sale terms, return and shipping details and the store’s AI answers) after a change; its results replace the seasonal report’s when done",
"enum": [
"keyword-lookup",
"check-page",
"is-indexed",
"check-product",
"speed-test",
"rich-result-test",
"set-product-kind",
"ask-assistant",
"ai-answer-for-product",
"compare-periods",
"topic-ideas",
"competitor-gaps",
"content-brief",
"google-results",
"redirect-check",
"internal-links",
"check-urls",
"title-test",
"backlink-check",
"seasonal-recheck"
],
"type": "string"
},
"input": {
"additionalProperties": {},
"description": "Fields by tool: keyword-lookup: keyword, country; check-page: page; is-indexed: page; check-product: product; speed-test: page; rich-result-test: page; set-product-kind: kind, products, vendors, types, tags, titles, note; ask-assistant: question, engine, country; ai-answer-for-product: productId, engine, country, question; compare-periods: page, days; topic-ideas: topic, country; competitor-gaps: competitor, country; content-brief: search, country; google-results: search, country, city; redirect-check: page; internal-links: page, limit; check-urls: urls, text; title-test: page, proposals, search; backlink-check: target; seasonal-recheck: country",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "run_seo_tool",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"query": {
"default": "",
"description": "Words from the title or handle. Leave empty to list by type in title order.",
"maxLength": 200,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"types": {
"default": [
"product",
"collection",
"page",
"article"
],
"items": {
"enum": [
"product",
"collection",
"page",
"article"
],
"type": "string"
},
"minItems": 1,
"type": "array"
}
},
"type": "object"
},
"name": "search_catalog",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"industry": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"limit": {
"type": "number"
},
"pageKind": {
"enum": [
"home",
"product",
"collection",
"auxiliary"
],
"type": "string"
},
"query": {
"type": "string"
},
"scope": {
"enum": [
"site",
"page",
"pattern"
],
"type": "string"
}
},
"required": [
"query",
"scope"
],
"type": "object"
},
"name": "search_design_references",
"outputSchema": null
},
{
"description": "Find theme files in a Fudge draft. With `pattern`, search contents by regular expression; without it, list files matching `paths` globs.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"paths": {
"description": "Files, folders or glob patterns, e.g. [\"sections\", \"snippets/*price*.liquid\"].",
"items": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
"pattern": {
"description": "Regular expression (RE2 syntax: no lookarounds or backreferences) to search for in those files.",
"maxLength": 500,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"paths"
],
"type": "object"
},
"name": "search_draft_files",
"outputSchema": null
},
{
"description": "Search Fudge’s reference articles on SEO, AI discovery, conversion, merchandising, content, store design and analytics. Returns matching paths and excerpts.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"description": "What the merchant wants to do or know, in a few words.",
"maxLength": 200,
"minLength": 2,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_guides",
"outputSchema": null
},
{
"description": "Send the Fudge team a problem with its tools, a capability you needed, or feedback the merchant asked you to pass on.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"message": {
"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.",
"type": "string"
},
"store": {
"description": "The connected store to use. Defaults to the first one.",
"type": "string"
},
"type": {
"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.",
"enum": [
"broken",
"stuck",
"hard",
"missing",
"merchant"
],
"type": "string"
}
},
"required": [
"type",
"message"
],
"type": "object"
},
"name": "send_feedback",
"outputSchema": null
},
{
"description": "Record the merchant’s answer from the preview consent card, with the answer code only that card receives.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"answer": {
"description": "The answer code from Fudge’s consent card.",
"maxLength": 200,
"type": "string"
},
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"scope": {
"description": "project: this draft only; site: every draft.",
"enum": [
"project",
"site"
],
"type": "string"
},
"state": {
"enum": [
"granted",
"declined"
],
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"scope",
"state",
"answer"
],
"type": "object"
},
"name": "set_preview_consent",
"outputSchema": null
},
{
"description": "Show 3–8 Lookbook references as a gallery of screenshots, best first, each with a one-sentence note on why it suits this store.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"references": {
"items": {
"properties": {
"note": {
"maxLength": 160,
"type": "string"
},
"ref": {
"type": "string"
}
},
"required": [
"ref"
],
"type": "object"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
}
},
"required": [
"references"
],
"type": "object"
},
"name": "show_design_references",
"outputSchema": null
},
{
"description": "Show a Fudge draft in the side panel with its screenshot, saved time, change count and links. Without a ref, lists recent drafts.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ref": {
"description": "A fudge://project/… ref.",
"type": "string"
},
"store": {
"description": "The connected store to use. Defaults to the first one.",
"type": "string"
}
},
"type": "object"
},
"name": "show_draft",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft"
],
"type": "object"
},
"name": "show_preview_consent",
"outputSchema": null
},
{
"description": "Show Fudge items to the merchant as rows that open in Fudge: work, Plans, findings, recommendations, reports, products and pages.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"refs": {
"items": {
"type": "string"
},
"maxItems": 12,
"minItems": 1,
"type": "array"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"refs"
],
"type": "object"
},
"name": "show_resources",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"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.",
"maxLength": 2000,
"type": "string"
},
"requestId": {
"description": "A unique ID you choose for this request, e.g. a UUID. Retries reuse it.",
"maxLength": 100,
"minLength": 8,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
},
"title": {
"description": "Short merchant-facing name for the work, e.g. “Size guide on product pages”.",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"work": {
"description": "A fudge://project/… ref to continue instead of starting new work.",
"maxLength": 200,
"type": "string"
}
},
"required": [
"title",
"requestId"
],
"type": "object"
},
"name": "start_draft",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"description": {
"description": "The store idea: what they sell, who for, and anything they’ve said about the brand.",
"maxLength": 2000,
"minLength": 12,
"type": "string"
}
},
"required": [
"description"
],
"type": "object"
},
"name": "start_store_builder",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"domain": {
"description": "The Shopify storefront, e.g. example.com.",
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"instructions": {
"description": "What the merchant wants from the redesign, in their words.",
"maxLength": 2000,
"type": "string"
}
},
"required": [
"domain"
],
"type": "object"
},
"name": "start_website_redesign",
"outputSchema": null
},
{
"description": "Stop Fudge’s reply running on one work item. With `runId`, stops only that run. The draft and anything already saved stay.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ref": {
"description": "The work’s fudge://thread/… or fudge://project/… ref.",
"type": "string"
},
"runId": {
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"ref"
],
"type": "object"
},
"name": "stop_work",
"outputSchema": null
},
{
"description": "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\".",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"content": {
"description": "The complete file content, without line gutters.",
"maxLength": 400000,
"type": "string"
},
"draft": {
"description": "The draft’s fudge://project/… ref.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"path": {
"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.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"replace": {
"description": "True to replace an existing file you have read in full.",
"type": "boolean"
},
"revision": {
"description": "The revision returned when this file was read, when replacing.",
"maxLength": 64,
"type": "string"
},
"store": {
"description": "The connected store to use. Omit when only one is connected.",
"type": "string"
}
},
"required": [
"draft",
"path",
"content"
],
"type": "object"
},
"name": "write_draft_file",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:b64590e36f78d10595ade3dc1932e34cb9cb441225e7bdf3ab10900aff1a8bd2 | sha256sum