wafle MCP server

List custom agents defined for a store. Each agent has system_prompt + tools whitelist + guardrails + trigger. Filter by status (draft/active/paused/archived) or trigger_type.

Get one agent by its slug — full definition including system_prompt, tools_allowed, guardrails, trigger_config and stats counters.

Patch an existing agent — change system_prompt, tools_allowed, guardrails, trigger_config, model, status, etc. Slug + tenant_id are immutable.

Activate an agent — moves status to `active`, which makes it eligible for scheduled/event triggers. No-op if already active.

Pause an active agent. Triggers stop firing; existing runs unaffected.

Manually dispatch a run for an agent. Returns the `run_id` and the synchronous run row (ends in status=done|failed|awaiting_approval). Use `wafle_agents_runs_get` to poll.

List runs for an agent — paginated, filterable by status. Each row: status, tokens, cost_cents, duration_ms.

Get a specific run with its full conversation + audit log (steps: user_input, assistant_text, tool_call, tool_result, approval_request, approval_granted, error).

Approve a run that is `awaiting_approval`. Resumes execution from the pending tool call. Optional `note` saved to the audit log.

Reject a run that is `awaiting_approval`. Run goes to `cancelled`; the pending tool call is NOT executed.

List the 5 pre-armed agent templates: customer-support-bot, content-writer-nightly, stock-watcher, abandoned-recovery, fraud-detector. Use the `id` field as `from_template` in `wafle_agents_create`.

List the catalog of tools that can be added to an agent's `tools_allowed`. Each entry: name, description, scope required, destructive flag, JSON Schema for input.

Aggregated stats for an agent: total runs, success rate, total cost, top tool names called.

Compile a natural-language description (e.g. 'clientes que compraron al menos 2 veces y abandonaron carro últimos 30 días') into the email-marketing segmentation DSL. Returns `{ dsl_json, validated, errors }`. Pass `dsl_json` straight into a new segment.

Summarize the approved reviews of a product into 2–3 sentences plus sentiment + key points. Output goes into a job; call `wafle_ai_jobs_accept` to cache the summary on the reviews aggregate row (24h TTL).

Auto-classify products without a category. Call with a list of SKUs and a list of allowed categories. Each product gets `{ category, confidence }` (or null if nothing fits). Accept the job to write category overrides into the catalog.

Customer-service co-pilot: classify an inbound message, gauge sentiment, decide if it needs escalation, and draft a friendly response. PII (emails, phones) in the message is redacted before being sent to the LLM.

Paginated list of AI jobs for a store. Filter by job_type, status, or user_review. Use to surface a 'pending review' queue or to find a specific recent job.

Fetch a single AI job by id. Includes input_payload, output_payload, tokens, cost, model, duration, and user review status.

Mark an AI job's output as rejected. Use to keep usage stats clean and to preserve learning signal for prompt tuning.

Save user edits on an AI job's output and apply them. For product_description, the edited text is what gets written to data.descriptions.<lang>.

Token + cost aggregate for a store since a date (defaults to last 30 days). Use for the AI dashboard chart and quota guidance.

List orders from the wafle_orders table for a store. Returns the new checkout pipeline (cart→MP/Stripe/transfer→paid). Filterable by status, date floor (`since`, ISO 8601), and customer email. For legacy WC orders use `wafle_orders_list` (different table).

Fetch one order from wafle_orders. `order_id` accepts either the numeric primary key or the public id (WK<L>-YYYY-NNN-rand) shown on the order detail page.

Refund a paid order — full when `amount_cents` is omitted/0, partial otherwise. Guardrail: any refund > 50% of total_cents requires `confirm:true`. The refund is recorded on the wafle_orders row; the gateway-side refund call is gateway-specific and currently records `manual_refund:true` in metadata …

Resend a transactional email tied to an order. Default template: `order_confirmation`. Idempotency-keyed by template+public_id+timestamp so retries don't double-send within the same minute.

Manually flip a transfer/cash order to paid (proof-of-deposit verified, cash collected at delivery). Returns 422 if the order is on a webhook-driven gateway (mp / stripe) — those move via /webhooks/* automatically.

List abandoned carts (cart_token has items but no `paid` order in wafle_orders) for a customer email hash. Used by retargeting drip flows to surface 'you left X in your cart' nudges.

Patch a coupon by id. Only sent fields change.

Delete a coupon by id. Past usage history is preserved on orders.

Fetch a single customer profile by email. Returns aggregated stats: lifetime value, order count, last seen, top SKUs.

List the orders of a single customer (by email).

List all customer segments configured for a store. Segments power the `segment=` filter in `wafle_customers_list` and the audience exports.

Export an audience formatted for Google Ads Customer Match: hashed email/phone with the column names Google expects.

List the server-defined prompts available on this MCP server. Returns name, description, and argument schema for each. Useful for clients that don't surface the prompts/list MCP method.

Fetch a single order by id. Returns customer, items, totals, gateway info, status, shipment data, timeline reference.

Add an internal or customer-visible note to an order. Notes appear in the timeline and (if `customer=true`) in the customer's order detail page + email.

Fetch the current marketing pixel IDs configured for a store: Meta (Facebook), TikTok, GA4, Google Ads.

Set / update marketing pixel IDs of a store. Pass only the pixels you want to change; omit fields stay untouched. Pass `null` to clear a pixel.

Patch an existing pricing rule by id.

Delete a pricing rule by id. Irreversible — confirm before calling.

Lightweight search of products by name/sku. Equivalent to `wafle_products_list` with `search` set, but optimized for autocomplete.

Fetch a single product by slug (the URL-friendly id). Returns full detail including variants, images, attributes and overrides.