MCP serverio.favcrm/favcrm

Step 1 of agentic team invite acceptance. Validates an invite token and sends a 6-digit verification code to the invited email. Then call accept_team_invite_verify with the code to

Step 2 of agentic team invite acceptance. Verifies the emailed code, joins the invited user to the company, and returns a one-time MCP API key for that user.

Add a free-form text document to the knowledge base. Use for pasted policies, FAQs, internal notes, brand voice references — anything the agent should be able to retrieve later. St

Append one or more blocks to the end of a post. Each block must be a valid block object: { id, version, type, data }. Types: paragraph, heading, image, list, quote, code, divider,

Archive a survey and remove it from active survey lists.

Assign a staff member to a booking service. Pass users.id from list_staff.userId.

Attach a previously generated ai-media job's output as the post's featuredImage. Use when generate_post_cover timed out (job kept running) or when reusing the same generation acros

Attach one or more tags to a member/account. Useful for segmenting members after filtering.

Cancel a booking and create a durable refund receipt. Uses the merchant refund setting unless refundMethod is provided.

Cancel a subscription. Destructive — turns off auto-renew and prevents further billing cycles. Existing paid periods stay valid until end.

Preflight whether an intended operation is allowed by token scopes, enabled modules, subscription state, and quota. Provide toolName, quotaCode, or moduleCode.

Duplicate an existing record (product, tier, campaign, post, service package, promotion, gift offer). Creates a copy in DRAFT status with "(Copy)" appended to the name.

Commit a previewed customer import. Pass the same rows and sessionId returned by preview_customer_import. Creates/updates accounts and applies points, stamps, and credit deltas.

Mark a booking as completed. Triggers commission calculation if configured.

Confirm a pending booking.

Convert an account: qualify its open lead (creating one if needed) and link exactly one pipeline deal. Also promotes lifeStage lead -> active. Safe to repeat — a second call lands

Copy the complete pricing and booking-policy configuration from one membership tier to another on the same booking service.

Create a CRM account/customer with a primary contact. Optionally enroll the account as a member; use enrol_membership later when the account already exists.

Create a new booking for a member. Use get_available_slots first to find valid times, then create the booking with the service, member, date, and time.

Create a DRAFT WhatsApp or SMS broadcast campaign. The broadcast is NOT sent — admin must review and send it from the Broadcasts page.

Create an email, SMS, WhatsApp, or push campaign in DRAFT. audienceExclusions can omit specific account IDs and recipients of previous campaign IDs. For email channelConfig, use su

Create a CMS post category (e.g. "Equipment", "Injection — Botox"). For sub-categories, use namespaced names — the table is flat.

Create a contact on an existing CRM account.

Create a custom field definition for CRM entities. Use options for select or multiselect fields.

Create a CRM sales pipeline deal, optionally linked to a customer account and contact.

Create a draft reply suggestion that appears inline in the FavCRM Inbox composer. Use this for message.inbound events with replyPolicy="suggest"; it does not send anything to the c

Create a new invoice for a customer. Optionally include line items inline. Returns the new invoiceId.

Add a note to a member/account, booking, ticket, or invoice.

Create an upsell/cross-sell offer rule as draft. Specify trigger type, conditions, and suggested products with optional discounts.

Create a shop outlet/location. Optionally pass id to preserve a legacy UUID during migration.

Create a Stripe Checkout link for a new paid subscription, or a Stripe Billing Portal link for an existing Stripe subscription. Use only after the user explicitly asks to upgrade o

Create a new CMS post (blog_post, page, or any custom post type). The post type must already exist — use list_post_types to discover, create_post_type to add a new one. excerpt = p

Define a new custom post type (e.g. "treatment", "service"). Required before creating posts of that type. After creating a post type, use create_post_type_field to define its struc

Add a custom field to a post type schema. The field key becomes the key in meta when creating/updating posts. Use fieldType="repeater" with fields=[...] for repeatable structured r

Create a new shop product as DRAFT. Merchant can review and activate from the portal.

Create a product category. Use parentId to create subcategories under an existing category.

Create a promotion / discount code. type=percentage or fixed_amount; value is the discount as a string ("10" = 10% or 10 currency units). Codes are uppercased server-side.

Create a bookable resource (room, equipment, vehicle). Used by services that have requiresResource=true.

Create a new customer segment. Use STATIC for manual member lists, DYNAMIC for criteria-based auto-filtering.

Create a bookable service. Sets duration, price, capacity, and policies. Use list_service_categories first if you want to attach to an existing category.

Create a service category (e.g. "Treatments", "Classes") to group bookable services.

Create a service package/prepaid session bundle. Use applicableType=SELECTED with applicableItems to limit the package to specific booking services or events.

Create a bookable schedule window for a service, including recurring weekly/daily availability.

Create a manual, non-renewing subscription record for a member. Use a subscription action link for provider-backed recurring billing.

Create a survey with custom question blocks. Publish it later or set status to published for immediate portal access.

Create a token-auth survey invitation for a specific member/account or contact.

Create a CRM tag for customer segmentation and organization.

Create a task. Optionally link to a CRM account or assign to a team member.

Invite a team member to this company and return a one-time MCP accept token. The invited user must verify an email code through accept_team_invite_request and accept_team_invite_ve

Create and submit a WhatsApp message template to Meta for approval. Text templates only (header text, body with {{1}} variables, footer) — add buttons in the app. The template is N

Create a support ticket for a member issue.

Add a variation (size, color, etc.) to an existing product.

Create a short-lived browser link for WhatsApp Business Embedded Signup. The user must open the link because Meta requires a browser popup to authorize and choose the WABA/phone nu

Soft-delete a CRM account/customer. This releases the primary phone for future reuse while keeping account history for audit.

Delete a campaign. Only allowed in DRAFT status; sent campaigns are kept for audit history.

Delete a CMS post category. Posts in the category are not deleted; they are simply unlinked.

Delete a secondary contact. Primary contacts are protected; set another primary contact or delete the account instead.

Delete a custom field definition and its stored values.

Soft-delete a CRM deal from the sales pipeline.

Delete a DRAFT invoice. Only invoices that have never been sent can be deleted; otherwise use void_invoice.

Soft-delete a knowledge document. The agent loses access immediately, but the document can be restored with restore_knowledge_document.

Delete a CMS post by ID. Soft-deleted posts can be restored with restore_post.

Delete a custom post type. Built-in types cannot be deleted. Fails if any posts of this type still exist — delete those first.

Remove a field from a post type schema. Blocked when posts of this type still have data in the field unless force=true is passed (orphans the data).

Delete a promotion. Past usage records are preserved.

Delete a customer segment.

Delete a service package by ID.

Delete a CRM tag and remove it from all tagged entities.

Soft-delete a CRM task.

Detach one tag from one or more member/account records.

Credit loyalty points or stamps to a member. Use field="points" for points, "stamps" for stamps. Server records a transaction with the reason as audit context.

Enrol a member into a membership tier. Free tiers enrol immediately; paid tiers return PAYMENT_REQUIRED unless skipPriceCheck is set. Use list_tiers first to find the target tier.

Execute an available FavCRM tool by name after discovering it with search_tools. Target tool availability, input schema, module gates, and audit logging are still enforced.

Find or create a Workroom DM thread between a merchant user and an AI colleague. Use this when an inbound event deserves owner attention but no threadId was provided. This only pre

Generate an AI image via kie.ai and return its public R2 URL. Use to mint reusable URLs for content blocks (image, gallery), product photos, or any field that takes an image URL —

Generate an AI image and attach it as a post's featuredImage. Submits a kie.ai job, polls until complete, copies the result into the canonical post-asset R2 folder, and writes the

Read the text/Markdown content of a file attached to a Workroom thread or sent by a customer (PDF, image, or document). Extracts on first read and caches the result. Returns status

Fetch a single audit log entry by ID, including before/after snapshots when available.

Find available booking slots for a service on a specific date.

Get full booking details including line items, status history, and participants.

Get global booking settings for the customer booking flow, cancellation rules, visibility options, and confirmation requirements.

Get booking counts: today, this week, this month, and breakdown by status.

Get a campaign by ID, including its recipient source, audience exclusions, channel configuration, and delivery stats.

Fetch a single contact by ID.

Get messages from a specific conversation thread. Shows the chat history between the merchant and a contact.

Get a custom field definition by ID.

Get custom field values for a CRM entity such as an account, contact, deal, or booking.

Get high-level business KPIs: member count, new members this week, active subscriptions, total points issued, active promotions, rewards redeemed, messages sent.

Get detailed CRM deal information by ID.

Resolve pending, confirmed, and paid event registrations into unique CRM account IDs for campaign exclusions. Pass accountIds to audienceExclusions only when ready=true; cancelled

Fetch a single invoice with line items, payment history, and customer detail.

Outstanding totals, overdue counts, and revenue this period. Used by the weekly-snapshot playbook.

Fetch a single knowledge document with metadata + extraction/review status. Reviewed content is served via GET /v6/merchant/ai/knowledge/{id}/content; raw/extracted variants are fo

Get a member's current loyalty balance — points, stamps, credits, lifetime totals, and active membership tier. Returns null if the member is not enrolled.

Get detailed profile for a specific member/account by ID.

Get a specific membership tier by ID.

Get offer rule detail including associated products and discounts.

Get full order detail including line items.

Show the current organisation plan, subscription/payment state, enabled modules, and quota usage. Use before deciding whether an agentic operation is allowed.

Get detailed CMS post including content blocks, categories, and tags.

Get full product detail including images, options, and variations.

Get details of a specific promotion/coupon code.

Get customer segment details including type, criteria, and live member count.

Get the members that belong to a specific segment.

Get full service details including addons, staff, resources, and tier pricing.

Get service package detail including applicability and selected booking service/event items.

Read every membership-tier pricing configuration for one booking service.

Fetch a single subscription with customer, tier, billing cycle, and renewal info.

Get survey detail, including blocks, publishing status, visibility, settings, and response count.

List responses for a survey.

Get response and invitation metrics for a survey overview dashboard.

Get detailed task information by ID.

Get ticket counts grouped by status.

Check whether WhatsApp Business is connected for this company, including WABA/phone metadata and the latest agentic connect session state.

Issue a gift/reward to multiple members. Requires a gift offer ID and member IDs.

Link a room/resource to a booking service.

List recent audit log entries for this company. Filter by action, resource, resourceId, user, source, outcome, destructive flag, and created date range.

List bookings with filters for date range, status, service, staff, or member.

List marketing campaigns (email, SMS, WhatsApp, or push) with delivery stats. Use the returned IDs when excluding recipients of previous campaigns.

List CMS post categories.

List contacts (people linked to CRM accounts), optionally filtered by account or search.

List messaging conversations across WhatsApp, Messenger, Instagram, Threads, SMS, email, and other enabled channels. Threads items are public conversations. Shows unread counts and

List custom field definitions for CRM entities such as account, contact, deal, or booking.

List CRM deals (sales pipeline) with optional filters.

List registrations for an event in the active company, including CRM account IDs for campaign exclusions.

List AI image-generation models exposed to merchants (sanitized — provider/cost details hidden). Use to pick a `modelCode` for `generate_post_cover`.

List invoices with optional filters. Use status "OVERDUE" to find unpaid invoices past due date.

List merchant knowledge base documents (uploads + scraped URLs). Use reviewStatus/syncable to see what is ready for agent retrieval. Pass `updatedAfter` for delta sync. Reviewed co

List all companies/organisations the current user has access to. Use this to see available orgs before switching.

List notes attached to a member/account, booking, or ticket.

List notification delivery logs for the current company. Recipients are masked by default for incident-response safety.

List upsell/cross-sell offer rules with optional filters.

List shop orders with optional status and search filters.

List shop outlets/locations for the company.

List active FavCRM plans with prices, quotas, included modules, and whether each is the current plan.

List the custom field schema for a post type. Use this before creating posts to know which keys to pass in meta and what types they expect.

List all post types defined for this company (built-in: blog_post, page; plus any custom types).

List CMS posts (blog posts and/or pages) with optional filters.

List all product categories for the shop.

List shop products with optional filters by name, status, or category.

List promotion/coupon codes with optional status filter.

List booking resources (rooms, equipment, etc.).

List loyalty reward schemes (points/stamps programs) configured for this business.

List customer segments. Segments group members by criteria for targeted campaigns.

List service categories (groups for booking services like "Treatments", "Classes").

List service packages/prepaid session bundles with optional search, status, sorting, and pagination.

List schedule windows for booking services.

List booking services with name, price, duration, and status.

List all shipping methods configured for the shop.

List staff/team members in the business.

List member subscriptions. Filter by status to find active, cancelled, or past-due subscriptions.

List survey invitation history without exposing token hashes or old invitation tokens.

List automation workflows attached to a survey.

List surveys with optional status/search filters.

List all available tags for the merchant.

List tasks with optional status, assignee, and account filters.

List the company's WhatsApp message templates with their Meta approval status (PENDING / APPROVED / REJECTED). Check this to see which templates are approved before referencing one

List support tickets with optional filters.

List all membership tiers with member counts and stats.

Mark a CRM deal as lost. Requires a lost reason.

Mark a CRM deal as won and set close date.

Mark an invoice as sent to the customer (transitions DRAFT → OPEN). Use after delivering the invoice via email or share link. Idempotent.

Mark a booking as no-show when the customer did not attend.

Pause an active subscription (status → past_due, no further auto-renew). Use resume_subscription to reactivate.

Post an internal message from an AI colleague into a Workroom thread. Use this to report findings, ask the owner for approval, or share source links after reading CRM/Inbox data. T

Preview a bulk customer import (max 2000 rows). Matches existing accounts by phone/email and shows create vs update actions plus points/stamps/credit deltas. Use commit_customer_im

Preview how many customers would match dynamic segment criteria before creating or updating a segment.

Search this company's reviewed knowledge base and return grounded snippets with source document IDs. Use for merchant policies, FAQs, pricing notes, brand guidance, and other uploa

Search FavCRM MCP tools, enabled skills, and feature areas for how to use the platform. Use before guessing tool names or JSON arguments.

Record a manual payment against an invoice (cash, bank transfer, cheque, card terminal). Updates invoice status to PARTIAL or PAID based on the running total.

Step 1 of agentic signup. Sends a 6-digit verification code to the email. After the user reads the code, call register_organisation_verify with it to finish and receive an API key.

Step 2 of agentic signup. Confirms the 6-digit code and creates the workspace. Returns an API key the agent should set as Authorization: Bearer <apiKey> for all subsequent FavCRM M

Remove the block at the given index (0-based). All subsequent blocks shift up by one.

Reorder blocks by passing block IDs in the desired order. The id list must contain every existing block id exactly once.

Reorder fields on a post type. Pass field IDs in the desired display order; sortOrder is updated to match.

Replace a single block at the given index (0-based). Avoids fetching the full post and re-sending all blocks via update_post.

Report a FavCRM platform issue when an agent finds a missing MCP path, tool failure, confusing schema, CLI/docs issue, or SDK fallback. Include logs, AI analysis, references, and c

Create a merchant-owned Workroom approval request for a customer-facing send. The agent must not call send_message, send_whatsapp_message, send_test_campaign, or send_campaign dire

Restore a previously deleted campaign.

Restore a previously deleted CMS post category.

Restore a previously deleted DRAFT invoice.

Restore a previously deleted knowledge document.

Restore a previously deleted CMS post.

Restore a previously deleted custom post type.

Restore a previously deleted field on a post type schema.

Restore a previously deleted promotion.

Restore a previously deleted service package by ID.

Resume a paused subscription back to active.

Revert an audited action by restoring the captured before snapshot. Only works for allowlisted target tables with full before/after audit snapshots.

Fetch a URL's content into the knowledge base. Server crawls the URL, stores the response body in R2, returns the new document ID. Failures store the row with status='failed'. Use

Search audit logs by free text across action, resource, resource ID, changes JSON, and metadata JSON.

Search across CRM accounts and contacts by name, email, or phone.

Search and filter members/accounts. Supports text search, date ranges, booking/activity history, membership tier, tags, and more. Use lastBookingBefore/inactiveDays to find inactiv

Search the available FavCRM tool catalog for relevant operations. Use this when the curated direct tool list does not contain the operation you need.

Set or clear custom field values for a CRM entity. Values are stored as strings; pass null to clear a value.

Set a contact as the primary contact for its CRM account and demote other contacts on that account.

Add an availability window for a resource. Use day-of-week + recurring=true for weekly schedules, or a specific date for one-off blocks.

Replace the members of a STATIC customer segment with the given account IDs. The segment is converted to STATIC.

Set the complete pricing and booking-policy configuration for one membership tier on a booking service.

Add an availability window for a staff member (companyMembers.id). Use day-of-week + recurring for weekly schedules, or a specific date for one-off changes.