{"id":"com.sparkinventory/spark","slug":"com-sparkinventory-spark","title":"Spark Inventory","description":"AI inventory management: stock, Demand ESP reorder recommendations and purchase orders.","version":"1.0.0","publisher":{"kind":"domain","id":"sparkinventory.com","label":"sparkinventory.com","url":"https://sparkinventory.com"},"website":"https://sparkinventory.com/connect-spark-to-your-assistant/","repository":"","remotes":[{"type":"streamable-http","url":"https://api.sparkinventory.com/mcp"}],"packages":[],"published":"2026-10-26","updated":"2026-10-26","status":"online","auth":"","latency_ms":2492,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"draft_rule","title":"Draft Rule from Natural Language","description":"Draft an automation rule from a plain-language description (e.g. 'block POs over $10k when created'). On success returns a DISABLED draft rule alongside any detected conflicts, an approver hint and the Spark bot it was filed under with the reason (botSuggestion; pass another bot's id as botId to update_rule to move it). The rule is saved but inactive — review and enable it via update_rule. Returns","read_only":false},{"name":"list_standard_reports","title":"List Standard Reports","description":"The standard reports run_standard_report can produce (the Reports page's ready-made answers): purchasing plan, inventory health, inventory position and runway, sales and margin, backorder risk, supplier reliability, inventory value and aging, inventory summary, stockout ranking and risk, dead stock, top sellers and the sales breakdown matrix. Each comes with what it answers and the arguments it ta","read_only":true},{"name":"delete_manufacturing_order","title":"Delete Manufacturing Order","description":"Delete a manufacturing order, named by id (GUID) or number, as the manufacturing order screen does. Only a draft or canceled order that no work order and no inventory movement references can be deleted; cancel an issued order instead. Requires Write + manufacturing.execute on an unpinned operator credential. In-app assistants get a confirm card the user applies.","read_only":false},{"name":"list_demand_evidence","title":"List Demand Evidence","description":"List the tenant's demand evidence records — durable research artifacts that give demand signals provenance (a URL, an excerpt, a structured claim about a market condition). Each row carries the scope (Item/Tag/Category), the claim, source details, review-by date, and status (Active/Superseded/Refuted). Default lists only active evidence; set activeOnly false to include superseded and refuted. Page","read_only":true},{"name":"list_saved_reports","title":"List Saved Reports","description":"The reports the signed-in user saved on the Reports page, newest first. Saved reports belong to one person, so this works only in the in-app assistant. Run one with run_saved_report.","read_only":true},{"name":"list_edi_item_mappings","title":"List EDI Item Mappings","description":"List the EDI item mappings (cross-references): which Spark item each trading partner's SKU or UPC stands for, with the customer's description, unit, the conversion to the Spark unit and the customer price. Filter by tradingPartnerId, itemId or a search over the customer SKU, UPC and description and the item's SKU and name. Paged (page, pageSize up to 200). Requires an operator (unpinned) credentia","read_only":true},{"name":"start_integration_connect","title":"Connect Integration","description":"Generate the provider authorization URL that starts connecting an integration (providers: shopify — requires shopUrl, amazon, qbo, xero, zoho_books, etsy). IMPORTANT: you cannot complete the connection yourself — hand the returned URL to a human Spark admin to open in their browser, then poll get_integration_status until connected. No secrets or tokens ever pass through this tool. Requires an oper","read_only":false},{"name":"import_customer_returns","title":"Import Customer Returns","description":"Record customer returns that were already processed in another system (a warehouse's daily returns feed, or a returns history) so demand velocity, daily consumption and the forecast net them. Without returns, demand is gross sales and is overstated. Each return: returnNumber (dedup identity), returnDate, optional salesOrderReference (the order number or customer PO / external order id of the sale)","read_only":false},{"name":"commit_labor_plan","title":"Commit Labor Plan","description":"Commit a run's scheduled labor draft as a reservation, as the labor planner screen's commit does: the crew it names can then start work on it from their my-work page, and its hours count against everyone else's plans. Refused unless the draft has a planned start and the qualified workers' calendars cover it (includeAuthorizedOvertime counts overtime they are authorized for). A committed run's new ","read_only":false},{"name":"move_stock","title":"Move Stock","description":"Move stock between locations — bin to bin inside a warehouse, or straight into another managed warehouse — the Inventory page's Move action. Only available (unreserved) units move. Each line names the item, quantity, source location (optional when the item is in one location) and destination location (defaults to the item's default location in the destination warehouse). The preview shows stock at","read_only":false},{"name":"get_labor_work_day","title":"Get Labor Work Day","description":"One worker's day, as their my-work page shows it: the runs they are committed to that day with their part of each crew, the work session running now, time recorded that day, and their open issues. day is a calendar date (YYYY-MM-DD) in the account's time zone; it defaults to today. In the app, omit worker for the signed-in user's own day (User role; their account must be linked to a worker). Namin","read_only":true},{"name":"create_supplier_price_book","title":"Create Vendor Price Book","description":"Create a vendor price book (rate card): name, optional per-tenant-unique code, currency, active window, interpolation mode, supported run quantities (runQuantityLimits), and either the spec attribute schema that keys its quantity-break grid, kind \"ItemPriced\" for a flat per-SKU list, or kind \"ComponentPriced\" for a sum-of-components cost model. The book is created EMPTY and DRAFT (it cannot price ","read_only":false},{"name":"list_supplier_price_books","title":"List Vendor Price Books","description":"List the org's vendor price books (rate cards): id, vendor, client attribution (null = shared house book), currency, active window, supported run quantities (runQuantityLimits), and the spec attribute schema. Archived (soft-deleted) books are excluded by default — set includeArchived=true to see them. A client-pinned token sees house books plus its own client's books. Paged: pass limit (1–100) wit","read_only":true},{"name":"cancel_purchase_order","title":"Cancel Purchase Order","description":"Cancel a purchase order that is Open, Created, Waiting Approval or Issued and has no delivery receipt (an order already being received is handled in receiving). The preview shows the order, vendor, total and status change. Requires Write + purchasing.execute.","read_only":false},{"name":"close_out_campaign","title":"Close Out Campaign","description":"Record a finished campaign's actuals: spend (with currency), impressions, clicks and attributed orders — at least one. Close-out opens the day after the campaign's last day in the workspace's time zone (see campaign.closeOutOpensOn). Recording again replaces the previous actuals; identical actuals change nothing. It does not change the plan's state or forecast. Identify the plan by planId, or by e","read_only":false},{"name":"create_purchase_orders_from_recommendations","title":"Draft POs from Recommendations","description":"Convert reorder recommendations into draft PURCHASE ORDERS in one call — the reorder→PO bridge. Runs the same canonical reorder detection as get_reorder_recommendations, takes its buy-from-vendor bucket, and creates draft POs GROUPED BY VENDOR AND WAREHOUSE (one PO per vendor per destination warehouse) at each item's current cost and suggested reorder quantity. Choose WHICH recommendations to conv","read_only":false},{"name":"list_simulation_scenario_runs","title":"List Simulation Scenario Runs","description":"List the latest 50 scenario runs of the simulation workspace this credential is connected to, newest first: name, status, when it ran, why it failed, and how many expectations passed. Read one with get_simulation_scenario_run.","read_only":true},{"name":"push_external_sales_orders","title":"Push External Sales Orders","description":"Push sales orders fulfilled OUTSIDE Spark for an External warehouse. They feed demand velocity without touching on-hand (the snapshot stays the inventory authority). Idempotent: each order is keyed by its stable externalOrderId — re-pushing the same id is a no-op.","read_only":false},{"name":"set_import_mapping","title":"Set Import Mapping","description":"Set (or replace) the declarative column mapping for a staged import session and validate it against EVERY staged row. Author the mapping from the profile get_import_session returns. For salesOrderHistory: fields keyed by canonical name (orderNumber, customerPurchaseOrder, orderDate, sku, upc, itemName, quantity, price, uomName, customerName, customerEmail); requires an identity field (orderNumber ","read_only":false},{"name":"get_stock_movements","title":"Stock Movements","description":"An item's stock movement history at one warehouse, newest first — the Inventory page's movement log: receipts, sales, adjustments, moves, transfers and (with includeReservations) reservations, each with the document, location, quantity, cost, who did it and the running available total. Use it to explain why stock changed.","read_only":true},{"name":"explain_demand_change","title":"Explain Demand Change","description":"Why an item's demand moved: its last 4 complete weeks of units against the expectation set by the 12 weeks before (direction down / up / flat, or insufficient_data), the weekly series with the same weeks last year, and the reasons Spark's own data supports — each with a category (seasonality, evidence, calendar, price_change, anomaly, stockout), a claim with its numbers, its source and a confidenc","read_only":true},{"name":"get_portfolio_health","title":"Get Portfolio Health","description":"The 3PL portfolio page: inventory value and overstock across clients, each client's health (score, at-risk SKUs, overstock), the largest overstocked positions, upcoming purchase-order arrivals and predicted reorders, and suppliers where several clients' reorders could ship as one run. Optionally narrow to some clients (ids from list_clients). 3PL accounts only; needs an admin.","read_only":true},{"name":"get_rate_components","title":"List Rate Components","description":"List all rate components on a ComponentPriced price book — keys, labels, basis formulas, rate entries, conditions, and clamps. Read-only. Use to inspect what a book will resolve before activation, or to verify components after loading them.","read_only":true},{"name":"upsert_item_sourcing_profile","title":"Upsert Item Sourcing Profile","description":"Create or update an item's sourcing profile (its default price book + production spec). Matching: with name, the item's profile of that name is updated (or created); without name, the item's single existing profile is updated — ambiguous or first-time cases require name. The item's owner is derived server-side; a book attributed to a different client is refused; the spec is validated against the b","read_only":false},{"name":"update_onboarding_intent","title":"Update Onboarding Intent","description":"Set or update this tenant's onboarding INTENT — what they want from Spark: goals, the data they already hold, the sales channels/integrations they plan to use, and free import-scope notes. PATCH semantics: omit a field to leave it unchanged; pass a value (including an empty list) to replace it. Planned channels drive onboarding — a non-empty list makes the checklist expect a connect-a-channel step","read_only":false},{"name":"list_diagnostic_investigations","title":"List Diagnostic Investigations","description":"List this account's diagnostic investigations, newest first. Returns an empty list when the feature is unavailable.","read_only":true},{"name":"reset_simulation_workspace","title":"Reset Simulation Workspace","description":"Return the simulation workspace this credential is connected to to its baseline, the client's data before anything was rehearsed (governed two-step, destructive): rehearsed records, the simulated books' postings and the captured QuickBooks requests go, and the simulated clock returns to real time. The next run saves a fresh baseline. Never touches QuickBooks. Requires a credential granted the sand","read_only":false},{"name":"save_b2b_store_settings","title":"Save B2B Store Settings","description":"Set up or change the B2B store (see get_b2b_store_settings): its address slug, name, logo, colors, whether it is open, whether browsing needs a sign-in, whether prices are shown and the minimum order. Only the fields you pass change; name storeName, logoUrl, primaryColor, secondaryColor or minimumOrderAmount in clear to empty them. Setting the store up for the first time needs a slug. The same rul","read_only":false},{"name":"create_supplier_return","title":"Create Supplier Return","description":"Send stock back to a supplier against a closed purchase order — the purchase order's Create supplier return. Each line names the purchase order line (or SKU) and how many units go back, at most what was received minus what is already on a supplier return. issue=true (default) also issues it like a sales order (it may wait for approval); it is then picked, packed and shipped out with pick_items, pa","read_only":false},{"name":"get_receipt_variances","title":"Receipt Variances","description":"Tenant-wide work queue of unresolved delivery-receipt variances — DR lines where the supplier-delivered cost and/or quantity differs from the sourced purchase order's line snapshot and no resolution decision (approve/reject/edit) has been recorded yet. Within-tolerance deltas are auto-approved at write time and never appear here. Each row carries varianceKinds (cost and/or quantity) plus the raw s","read_only":true},{"name":"record_invoice_payment","title":"Record Invoice Payment","description":"Record a payment received outside Spark (cash, check, bank transfer, card taken elsewhere) on an issued invoice — the invoice list's Mark as paid. Nothing is charged: this never runs a card or bank payment. The amount defaults to what is still owed; a smaller amount records a partial payment, and more than is owed is refused. The invoice is marked paid once its payments cover it, and the payment p","read_only":false},{"name":"transition_work_order","title":"Change Work Order Status","description":"Move one work order to a new status: approve (waitingApproval to readyForProduction), mark_ready (open or onHold to readyForProduction), hold (open to onHold), or cancel (any work order not started, completed or cancelled; returns its reserved stock to available stock and frees its machines). A work order a manufacturing order generated is not cancelled here: cancel the manufacturing order. Starti","read_only":false},{"name":"acknowledge_action","title":"Acknowledge Action","description":"Preview or commit acknowledgment of one Signal Center event. Acknowledgment stamps the first-read time and resolves its linked source notification; it does not approve, execute, or dismiss anything. First call without receipt/key, then repeat identically with both. Requires Write plus actions.prepare.","read_only":false},{"name":"run_standard_report","title":"Run Standard Report","description":"Run one standard report by name (list_standard_reports lists them and the arguments each takes) and return its rows. Pass only the arguments that report lists; any other is refused. Examples: report=top_selling_items with topN=10 and periodDays=30; report=sales_margin with periodDays=90; report=inventory_position with sortBy=runway. At most 200 rows.","read_only":true},{"name":"create_quote","title":"Create Quote","description":"Draft a quote for a customer — the Quotes page's New quote. Lines are priced from the price book for that customer unless you give unitPrice; the preview shows the totals after discounts and tax. The quote is numbered and saved as open; nothing is reserved or sent. update_quote_status marks it accepted, and convert_quote turns it into a sales order or invoice. Two-step: preview=true, then commit w","read_only":false},{"name":"restore_simulation_snapshot","title":"Restore Simulation Snapshot","description":"Put the simulation workspace this credential is connected to back exactly as a snapshot holds it, simulated clock included (governed two-step, destructive). Everything done since — rehearsed or imported — is replaced, and unfinished scenario runs are stopped. Never touches QuickBooks. Requires a credential granted the sandbox.reset capability. Call with preview=true first to see what it replaces a","read_only":false},{"name":"issue_purchase_order","title":"Issue Purchase Order","description":"Issue a purchase order that is in Created status. An order a person has already approved is issued; an unapproved order is routed to Waiting Approval instead, because an assistant never approves a purchase order. The preview shows the order, vendor, total and the status it will move to. Requires Write + purchasing.execute.","read_only":false},{"name":"get_item_stock_outlook","title":"Item Stock Outlook","description":"Stock outlook for a list of items (by SKU, max 100): available (net of committed, the units open sales and transfer orders hold, as the Inventory page and Shopify show it), committed, inbound, and the two days-of-supply metrics — daysOnHand (stock before committed units ÷ the planning rate, which already counts open orders: the stockout-urgency signal) and aggregatedInventoryDays (including inboun","read_only":true},{"name":"delete_uom","title":"Delete Unit of Measure","description":"Delete a unit of measure by id (GUID) or exact abbreviation, as the Settings page does (a soft delete). Refused while any item or unit conversion uses it, and for the default unit (make another unit the default first with save_uom). Requires an operator (unpinned) credential.","read_only":false},{"name":"save_edi_trading_partner","title":"Save EDI Trading Partner","description":"Create or edit one EDI trading partner. Omit id to create (name required; a new partner is active and in test mode unless set); pass id to edit, where every omitted field keeps its value. Codes are unique per tenant. Connection settings (VAN, AS2 or SFTP credentials) are not set here: an edit keeps them, and they are entered in the app. Requires an operator (unpinned) credential.","read_only":false},{"name":"execute_manufacturing_step","title":"Execute Manufacturing Workflow Step","description":"Perform one manufacturing step using preview=true first, then repeat the identical request with sourceVersion from the preview, previewReceipt and a fresh idempotencyKey after review. Read get_manufacturing_order first: its productionMode says which steps the order takes. Actions: create_draft (warehouseId and 1–50 lines; optional plannedStartAt and plannedCompletionAt as YYYY-MM-DD dates), issue ","read_only":false},{"name":"find_dead_stock","title":"Find Dead Stock","description":"Dead stock: on-hand items with ZERO sales velocity over the window (week/month/quarter, default month) — the same definition as the stock-health dead-stock factor (days-of-supply is null when there is stock on hand but no sales). Returns a value-ranked, paged list; each item carries its available quantity (reserved units excluded: they are already sold) and dead value (those units at the item's co","read_only":true},{"name":"get_campaign_readiness","title":"Campaign Stock Readiness","description":"Stock readiness for a demand forecast plan (built for campaign plans; any plan type works): for each plan item at the Expected and the Optimistic scenario, the projected stock-out date and the plan day it falls on, days of cover at plan start, open purchase-order receipts landing before and during the plan window, the effective lead time, and whether a reorder placed today still lands before the s","read_only":true},{"name":"upsert_customers","title":"Upsert Customers","description":"Create or update customers in the partner master (max 500 per call) — for customer lists that don't arrive via import_historical_sales_orders. Matched by email (case-insensitive) first, falling back to exact name — so a row with an email still converges onto an existing same-name partner and enriches it. Besides contact details a row can set vatIdNumber, customerSegment (individual | distributor |","read_only":false},{"name":"trigger_qbo_purchase_backfill","title":"Start QuickBooks Purchase Backfill","description":"Start a historical purchase backfill from QuickBooks Online: a durable background import of PurchaseOrder and Bill documents from QBO into Spark's purchasing graph. Seeds suppliers, items, lead times, and vendor terms so forecasting works immediately. USD only; 36-month window. Idempotent — returns the existing run if one is active or completed. Poll progress via get_integration_status (provider '","read_only":false},{"name":"start_labor_session","title":"Start Labor Session","description":"Clock the signed-in worker in on a run they are committed to, as the start button on their my-work page does: a work session on one phase (setup, attendedRun or cleanup) of a committed labor plan starts now. Name the run by operationId, or by workOrder and operationCode (get_labor_work_day lists the worker's runs). phase defaults to the worker's only phase in the run. Refused when the plan changed","read_only":false},{"name":"preview_spec_fill","title":"Preview Spec Fill","description":"Preview what a spec fill would do WITHOUT writing anything. Returns the affected item count, a sample of up to 10 items with before→after for each attribute, and the resolved spec values. Use this to verify the filter and values before calling apply_spec_fill with a previewReceipt.","read_only":true},{"name":"get_manufacturing_readiness","title":"Check Manufacturing Setup","description":"Check manufacturing setup: BOM validity and unit conversions, internal warehouses, material suppliers and policies, opening stock and first-build progress. This is distinct from forecast readiness. Does not assert that a particular build has enough stock; inspect a draft manufacturing order for that. Operator credentials only.","read_only":true},{"name":"invite_b2b_customer","title":"Invite B2B Customer","description":"Invite a customer contact to the B2B store, as the B2B Customers page does: records an invitation and, once committed, emails the contact a link to set a password and sign in. The contact buys for the customer named by customerId (a customer business partner id; find it with lookup_business_partners) and sees that customer's prices and orders. The store must be set up and open, and the email must ","read_only":false},{"name":"import_historical_purchase_orders","title":"Import Historical Purchase Orders","description":"Import HISTORICAL purchase orders (already received in a previous system). receivedDate − orderDate becomes the OBSERVED LEAD TIME the reorder engine reads (POs from the last 12 months count; it needs at least 3 per item to beat the vendor default), so spread real dates rather than inventing them. Also seeds the purchasing graph: vendors are created by name (new ones get a default lead time from t","read_only":false},{"name":"update_supplier","title":"Update Vendor","description":"Update a vendor by id. Every field is preserve-on-omit — omitting a field keeps the vendor's current value (it is NOT cleared). Changing name/code/tax/bank re-checks uniqueness. customFields merges per key (see list_custom_fields with entity=businessPartner): omitted keys keep their value, an explicit null clears one, and an unknown fieldName fails the whole call at preview. Only existing vendors ","read_only":false},{"name":"report_onboarding_issue","title":"Report Onboarding Issue","description":"Send the person's own report about one of the account's onboarding issues to the Spark team, with their comment. The issue card calls this when the person picks Report this issue and writes what happened; call it yourself only when the person asks you to tell Spark about an issue from get_onboarding_issues, and pass their words as the comment, not your summary. issueId is the issue's id from get_o","read_only":false},{"name":"replace_price_book_breaks","title":"Replace Price Book Breaks","description":"REPLACE a price book's entire quantity-break grid (full-replace semantics: the supplied list becomes the whole grid; prior breaks are removed). Price changes automatically flag affected live quotes Stale and alert the operator. Empty lists are refused — clearing a grid is an operator action. A client-pinned token can only modify its own client's books, never the shared house books. Max 500 breaks ","read_only":false},{"name":"map_price_book_attribute","title":"Map Price Book Attribute","description":"Bind one price-book attribute to a canonical ITEM custom field by stable GUID during import, or atomically replace its confirmed mapping on an active book. For a closed enum, provide every exact vendor bookValue and the stable canonicalOptionId it represents. Vendor keys, labels, values, and grid rows stay unchanged; the saved adapter translates an item's option id into this book's value at pricin","read_only":false},{"name":"list_simulation_workspaces","title":"List Simulation Workspaces","description":"List your consulting partner's simulation workspaces: one per client you are onboarding, each its own Spark account where the client's data comes in and nothing is ever sent to QuickBooks. Shows each workspace's client, owner, when it is deleted, whether you can open it, and which one this credential is connected to. The partner is the one you are on the team of; it is never a parameter. Acts as a","read_only":true},{"name":"import_qbo_master_data","title":"Import QuickBooks Master Data","description":"Bring the connected QuickBooks Online company's products, vendors (as suppliers) and customers into Spark as records, and optionally QuickBooks' on-hand quantities as opening stock. Call it with preview=true first (the default): it reads QuickBooks and reports what would be matched, created or skipped, writing nothing. Show the person those counts and ask before calling again with preview=false. P","read_only":false},{"name":"get_data_readiness","title":"Data Readiness Audit","description":"Audit whether the tenant's data can power each product capability — the answer to 'why are my recommendations empty?'. Returns, per capability (forecast_foundation, reorder_recommendations, demand_forecasting, days_of_supply, inventory_health), a ready/partial/not_ready status derived from its REQUIRED data gates, plus every gate's coverage numbers (e.g. items with a confident demand signal / supp","read_only":true},{"name":"preview_labor_capacity","title":"Preview Labor Capacity","description":"Check whether the planned labor fits the workers' calendars over whole days in the account's time zone: feasible, unknown (a calendar or plan is missing) or overloaded, with the planned person-hours and each slice that is short of crew and the operations in it. from is YYYY-MM-DD (defaults to today); days is 1–30 (default 7). includeAuthorizedOvertime counts overtime windows as available. Labor al","read_only":true},{"name":"commit_import_session","title":"Commit Import Session","description":"Preview and commit a staged import session (governed two-step): call with preview=true for a full-pipeline dry-run — order count, date range, monthly historical shipped units, included/source date ranges, rows and orders omitted by the 36-month limit, would-create catalog counts, plus mapping and boundary-month warnings — and a single-use previewReceipt; show the customer the included range and mo","read_only":false},{"name":"apply_labor_default","title":"Apply Labor Default","description":"Recalculate a run's labor draft from its operation's reviewed default, as the labor planner screen's apply-default does: the default's per-run and per-unit minutes become the draft's elapsed time and attendance, keeping its planned start. Only for a run that is not committed, not started and has no recorded time; the draft then awaits review, which committing it gives. Needs an enabled default (sa","read_only":false},{"name":"list_demand_curve_assignments","title":"List Demand Curve Assignments","description":"List item-level demand-curve assignments with full provenance: which item and warehouse carry which curve, the level mode, whether the assignment is enabled, and who created it (source User/Rule/McpTool plus a sourceRef note). Optionally narrow to one curve (curveId) and/or one item (itemId). Paged: returns Total (pre-paging) plus the page; default 100, max 500 per call.","read_only":true},{"name":"get_edi_overview","title":"Get EDI Overview","description":"The EDI dashboard: transaction counts (total, sent, received, failed, awaiting acknowledgment, and created today, in the last 7 and 30 days by the tenant's local day), each trading partner's totals, failures, pending count and last activity, and the 10 latest transactions. Documents are exchanged only through a connected Orderful account. Requires an operator (unpinned) credential.","read_only":true},{"name":"check_simulation_scenario","title":"Check Simulation Scenario","description":"Check a scenario file against the simulation workspace this credential is connected to without running it: every problem in the file and every item, supplier, warehouse or purchase-order quantity the workspace does not have, plus a plain-language reading of each step. ready=true means run_simulation_scenario will accept it. Use it after writing or editing a file, and show the user the steps before","read_only":true},{"name":"dry_run_rule","title":"Dry-Run Rule","description":"Replay a candidate rule against the recent audit log without firing actions. Shows how many audit events the rule would have matched and the details of each match. Use to test a rule before saving. sampleDays clamped to [1, 90], maxResults clamped to [1, 100]. Read-only.","read_only":true},{"name":"rollback_import_session","title":"Roll Back Import Session","description":"Roll back a committed import — staged or inline (governed two-step, destructive): for sales-order imports, soft-deletes every order the session created and removes their seeded demand records so velocity/forecasting return to the pre-import state; for purchase-order imports, soft-deletes the POs; for customer-return imports (staged or import_customer_returns), soft-deletes the return orders so dem","read_only":false},{"name":"draft_simulation_scenario","title":"Draft Simulation Scenario","description":"Turn a plain-language description of business events into a scenario file for the simulation workspace this credential is connected to, for example \"PO 1042 arrives three units short, then the bill comes in 5% higher\". Spark's own drafting model writes the file from the workspace's real orders, SKUs and suppliers, checks it against the workspace and repairs it, and answers with the file (format \"s","read_only":false},{"name":"get_workflow_guide","title":"Get Workflow Guide","description":"Returns the rules for one area of Spark: which tools to call in what order, what each one may and may not do, and the errors to expect. Call it before your first call in an area the server instructions list under WORKFLOW GUIDES, and follow what it says. Reads nothing from the account.","read_only":true},{"name":"list_ship_lists","title":"Ship Lists","description":"The packing and shipping queue — the Shipping page. Each ship list is one warehouse's picked units for an order, waiting to be packed and shipped, with its status (created, inprogress = packing, readytoship, shipped), priority, shipper and quantities to ship, packed and shipped. Defaults to open lists (not yet shipped), oldest first. Call get_ship_list for a list's lines and packages.","read_only":true},{"name":"suggest_curves_for_items","title":"Suggest Curves for Items","description":"Which existing demand curve fits these items best? Derives the items' observed 12-month seasonal shape from their sales history and ranks the tenant's seasonal curves by cosine similarity to it (best fit first, 0..1). Use before apply_demand_curve_to_items to pick a curve for a batch of items; when hasSignal is false the items have too little history to compare — judge individual items with get_it","read_only":true},{"name":"set_item_images","title":"Set Item Images","description":"Set the main product image on EXISTING items by SKU (max 500 per call). Each row names an item (sku) and an absolute http(s) imageUrl on the scheme's default port; the server downloads the image (10 MB cap, must serve image/* from a public host) and sets it as the item's main image, REPLACING any current main image (the previous image stays in the gallery). Unknown SKUs report invalid — create ite","read_only":false},{"name":"list_rules","title":"List Rules","description":"List the tenant's automation rules. Without filters returns all company rules (admin) or the caller's personal + all company rules (non-admin). Optional scope (company / user) and ownerUserId narrow further. Returns the full rule definition for each, including trigger, conditions, actions, execution mode, and priority. Read-only. Paged: pass limit (1–100) with offset; omit limit for every rule up ","read_only":true},{"name":"trigger_shopify_order_backfill","title":"Start Shopify Order Backfill","description":"Start the historical Shopify order backfill: a durable background import of the order history that predates the store's connect date. Live tenants only — sandbox/trial tenants keep the connect-date cutoff and are refused. At most one backfill runs per store; re-triggering while one is active is refused. Poll progress via get_integration_status (provider 'shopify'). Requires an operator (unpinned) ","read_only":false},{"name":"update_sales_order","title":"Update Sales Order","description":"Edit an OPEN sales order the same way the Sales Orders page's Save does: add lines (addLines — itemSku/itemUpc/itemId + quantity, optional unitPrice), change lines (updateLines — lineId from get_sales_order plus a new quantity and/or unitPrice), remove lines (removeLineIds), and change the customer (customerId / customerEmail / customerName), the customer PO reference, the requested ship date, or ","read_only":false},{"name":"create_warehouse","title":"Create Warehouse","description":"Create a warehouse (name + unique code required; type defaults to internal). Runs the canonical creation path: duplicate-name/code check, a default receiving location, and a companion store (same name as the warehouse, returned in stores[] with its own storeId — that storeId, never the warehouse id, is what sales-order import surfaces take). Pass customFields to set tenant-defined custom field val","read_only":false},{"name":"plan_labor_operation","title":"Plan Labor Operation","description":"Save a run's labor draft, as the labor planner screen does: how long the run takes (elapsedMinutes, 1–44640), an optional plannedStart (ISO 8601 with an offset or Z), and the complete list of who attends when (requirements, at most 50: a qualified pool by id or name, an optional named worker from it, the phase, offsetMinutes from the run's start, durationMinutes and crewSize). The list replaces th","read_only":false},{"name":"upsert_items","title":"Upsert Items","description":"Create or update catalog items by SKU (max 500 per call) — the direct seeding path for catalogs that don't arrive via import_historical_sales_orders or a channel sync, and the way to enrich existing items. Besides cost, price, barcodes and type, a row can set the built-in attributes: dimensions (length/width/height/diameter + dimensionUom), weight + weightUom, volume + volumeUom, cartonQuantity, t","read_only":false},{"name":"save_discount","title":"Save Discount","description":"Create or edit a catalog discount, as the Discounts page does. Omit discountId to create (name, type and discountPercentage required); pass it to edit, where every omitted field keeps its value and a supplied items/brandIds/categoryIds list replaces the old one. type: general (everyone), coupon (couponCode required, unique) or business (businessDiscountGroupId from list_discounts). validFrom and v","read_only":false},{"name":"delete_discount","title":"Delete Discount","description":"Delete a catalog discount by id, as the Discounts page does. The preview shows the discount and how many items it matches; their discounted prices update on commit. To pause a discount instead, set its validUntil with save_discount. Requires an operator (unpinned) credential.","read_only":false},{"name":"request_diagnostic_investigation","title":"Request Diagnostic Investigation","description":"Start a deep diagnostic investigation into why something is not working the way the user expects (missing run proposals, unexpected signals, unexplained errors). Requires Write scope to persist and enqueue work. Runs in the background for a few minutes; the result is delivered as a notification and is readable via get_diagnostic_investigation. Use only after the deterministic reads (such as get_da","read_only":false},{"name":"create_purchase_order","title":"Create Purchase Order","description":"Create a forward PURCHASE ORDER to a vendor — a draft (status \"created\") an operator then issues. Give the vendor, the destination warehouse, and the lines to buy; each line names an item (by itemSku OR itemId) and a quantity, with an optional unitCost (omit it to price from the vendor's price book, then the item's catalog cost, then its last purchase cost — each preview line names its costSource)","read_only":false}],"server_info":{"name":"Inmana.Server","version":"1.0.0.0"},"category":"ecommerce","tags":["finance","analytics","developer"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-26","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/com-sparkinventory-spark/"}