MCP CATALOG · MODEL CONTEXT PROTOCOL

Agent-callable
from anywhere.

165 typed Model Context Protocol tools — customers, bookings, loyalty, invoices, payments, WhatsApp / SMS / email — installable on every agent that speaks MCP. Annotations on every entry, scopes per workspace, no SDK to learn.

CURSOR · CHAT

you › Sign me up for FavCRM. Yoga studio called Stretch + Breathe in Hong Kong.

agent › Sent a 6-digit code to ow***@example.com. Paste it here when ready.

you › 382915

agent › Workspace ready. API key stored. What's first?

NO PORTAL · NO FORM · OTP-GATED · 30 SECONDS

01 · About

What is FavCRM MCP?

FavCRM MCP is the agent-callable backend of FavCRM, a customer-relationship platform built for service businesses — beauty salons, fitness studios, tutoring, retail, hospitality, professional clinics. It exposes 165 typed Model Context Protocol tools and public SKILL.md workflow packages at api.favcrm.io/mcp, callable from any MCP-compatible client.

Endpoint
api.favcrm.io/mcp
Transport
Streamable HTTP
Auth
Bearer · OAuth 2.0 · OTP signup
Spec
MCP 2024-11-05+
Hosted
Cloudflare D1 + Workers (HKG)
Source of truth
/server-card.json

Facts on this page verified . Live tool count + manifest at the server-card endpoint above.

Total tools
165

Across 24 scopes — read, write, hints

Agentic signup
0 forms

Agent calls register_organisation_request → _verify; OTP-gated

Annotations
165 / 165

title · readOnly · destructive · openWorld · idempotent

Hosted at
HKG

Cloudflare D1 + Workers, primary region Hong Kong

03 · Built for service businesses

When the customer books a slot, not a deal.

The catalog (services, capacity, no-show penalties, tier-gating, recurring billing) is purpose-built for the verb "book". Not a sales-pipeline CRM with bolted-on calendars.

  • Beauty & wellness

    Salons, spas, nail bars, aesthetic clinics.

    • Multi-staff schedules
    • Tier-gated services
    • WhatsApp reminders
    • No-show penalties
  • Fitness & studios

    PT studios, yoga, pilates, boxing, group classes.

    • Class capacity rules
    • Package + drop-in
    • Membership renewals
    • Recurring billing
  • Tutoring & education

    Language schools, music tutors, exam prep.

    • 1-on-1 + group lessons
    • Student progress notes
    • Parent comms
    • Term invoicing
  • Retail & shop

    Boutiques, specialty retail with online + in-store.

    • Customer + order history
    • Loyalty points
    • Promo codes
    • Stripe payment links
  • Hospitality & F&B

    Cafés, bistros, members-only clubs.

    • Reservations
    • Member-only events
    • Loyalty stamps
    • Birthday campaigns
  • Professional services

    Clinics, consultants, advisors, allied health.

    • Recurring appointments
    • Treatment notes
    • Insurance invoicing
    • Outcome tracking
04 · Named playbooks

37 skills, slash-callable.

Pre-built recipes for daily-driver workflows. Type a slash in Cursor or Claude — the agent picks the right tools in the right order. Zero prompt engineering, no SDK to learn.

Customers

Onboarding, lifecycle, profile

  • /add-customer

    Create a contact with optional tags + notes

  • /onboard-member

    Account → tier → welcome reward + message

  • /enrol-customer-tier

    Move an existing customer between tiers

  • /customer-360

    Compile a full profile across bookings / loyalty / orders

  • /find-top-customers

    Identify VIPs and at-risk by lifetime spend

Loyalty

Points, rewards, redemptions

  • /add-loyalty-points

    Lookup → balance → earn → confirm new total

  • /issue-gift-reward

    Pick gift offer + issue + customer notify

Bookings

Full lifecycle, comms, exceptions

  • /book-customer

    Search → service → slot → book + confirm + notify

  • /cancel-and-refund

    Destructive flow with safety gate + refund chain

  • /handle-no-show

    Mark + penalty trigger + follow-up

  • /send-booking-reminder

    Tomorrow's confirmed → WhatsApp loop

  • /complete-booking

    Confirm a pending booking

  • /review-cancellations

    Pattern analysis on cancelled bookings

Service config

Catalog, pricing, promotions

  • /create-service

    Service + schedule + staff + resource

  • /set-up-promotion

    Code + limits + dry-run validate

Comms

Outbound campaigns, support, inbox

  • /send-campaign

    Segment → preview → bulk send

  • /respond-to-ticket

    Reply + status update

  • /inbox-triage

    Triage unread customer conversations

Segmentation

Tags, segments, cohort building

  • /bulk-tag-segment

    Filter cohort + tag + optional segment

  • /build-segment

    Create + verify a customer segment

Content & orders

CMS posts, shop fulfilment

  • /publish-blog-post

    Post type → draft → blocks → publish

  • /generate-blog-post

    AI cover + structured blocks → publish

  • /fulfil-order

    Shop order → fulfil + tracking info

Billing & invoicing

Invoices, payments, dunning

  • /bill-customer

    Create invoice with line items + send to customer

  • /record-payment

    Find unpaid invoice + record manual payment

  • /chase-overdue-invoices

    Send payment reminders for overdue invoices

  • /void-invoice

    Void invoice (destructive, with safety gate)

Subscriptions

Recurring revenue lifecycle

  • /start-subscription

    Member + tier + cycle + welcome message

  • /cancel-subscription

    Confirm + optional save attempt + cancel

  • /pause-subscription

    Temporarily halt billing (resumable)

  • /handle-past-due

    Find past-due subs + payment recovery outreach

Sales & ops

Pipeline, tasks, multi-workspace

  • /manage-deal

    Move deal through pipeline stages

  • /manage-task

    Create / assign / update internal tasks

  • /switch-workspace

    Switch active workspace (multi-org)

AI knowledge

Train the merchant agent

  • /train-ai-agent

    Scrape URL or paste text into the knowledge base

  • /prune-knowledge

    Audit + delete outdated or failed documents

Reporting

Snapshots and ops summaries

  • /weekly-snapshot

    7-day dashboard + bookings + revenue markdown

Surfaced via MCP prompts/list Shape: /playbook-name in chat
05 · Compared

Where FavCRM earns its place.

Not a HubSpot replacement. Not a generic MCP wrapper. Built for service merchants whose agents need to actually do things.

Dimension
FavCRM MCP
Generic MCP servers
Legacy CRM (HubSpot, Salesforce)
Tool count
165 typed
5–30 typically
0 (REST only)
Agentic signup (no form)
OTP-gated
Portal click
Sales call
MCP annotations on every tool
165 / 165
Often missing
N/A
Output schemas declared
data + summary + renderType
Mixed
N/A
Named playbooks (slash commands)
37 covering full lifecycle
Tools only
N/A
OAuth 2.0 + PKCE-S256 + DCR
RFC 8414 / 7591 / 7636 / 7009
API key only
Custom SSO
Free tier
100 customers · 200 bookings/mo
Trial only
Per-seat from $50+
Hosted on edge
Cloudflare D1 + Workers (HKG)
Mixed
Single region

yes   partial   no   · note. Verified .

06 · Also compatible

Any MCP client speaks the same protocol.

The api.favcrm.io/mcp endpoint accepts Streamable HTTP transport from any MCP-spec client. The four pages above are install guides for the most common ones — others wire in via the same Bearer-header pattern documented in the public examples repo.

WindsurfContinue.devZedClineRoo CodeReplit AgentSmithery
github.com/favcrm/mcp

Per-token scoping

Every issued token is bound to one user, one workspace, one client. Superadmin tools (raw SQL, plan management) physically unreachable.

Annotations on every tool

tools/list surfaces title + readOnlyHint / destructiveHint / openWorldHint. Clients can flag destructive calls before invoking.

DCR with quarantine

RFC 7591 dynamic registration accepted, rate-limited 50/IP/day. New clients write-locked for 24h; users explicitly re-consent for destructive scopes.

07 · Frequently asked

The questions agents ask.

Phrased to mirror search queries. If you reached this page from Perplexity / ChatGPT / Claude looking for an answer, you should find it inline below — exact same wording lives in the page's FAQPage schema.

Q.01 What is FavCRM MCP?
FavCRM MCP is the agent-callable backend of FavCRM, a CRM for service businesses. The MCP server is hosted at api.favcrm.io/mcp and exposes 165 typed tools across customer, booking, loyalty, invoicing, subscriptions, content, team onboarding, WhatsApp setup, and communications. Any MCP-compatible client (Vercel v0, Cursor, Claude, ChatGPT, Smithery, Windsurf, Continue.dev, Zed) can call these tools directly from a chat or editor.
Q.02 How does a user sign up via an MCP client?
Two paths. The agentic path: with FavCRM connected to the client (no API key yet), the user asks the agent "sign me up for FavCRM" — the agent calls register_organisation_request, the server emails a 6-digit code, the user pastes it back, and the agent calls register_organisation_verify to receive a fav_mcp_* API key. The whole flow is OTP-gated and rate-limited (3/hour, 20/day per IP). Alternatively users can sign up via the favcrm.io portal and copy a key from Settings → MCP Keys.
Q.03 How is FavCRM different from HubSpot AI or Salesforce Einstein?
FavCRM is built MCP-first for service businesses. Tools are protocol-typed and callable from any agent, not just a vendor copilot; signup is agent-driven; pricing starts at a free tier covering 100 customers and 200 bookings/month. HubSpot and Salesforce target enterprise sales-org workflows and price per seat from $50+. Use FavCRM if your customers book services, classes, or memberships. Use HubSpot or Salesforce if your customers are leads in a B2B sales pipeline.
Q.04 What does FavCRM MCP cost?
Free tier: 100 customers, 200 bookings/month, 1k MCP calls/month, no credit card. Paid plans start at $19/mo (Lite — 1 seat) and scale to $49/mo (Starter — 3 seats, 1M AI credits, WhatsApp + SMS) and Enterprise (custom pricing). All plans include the same 165 MCP tools.
Q.05 Which MCP clients are supported?
Live and tested: Vercel v0 (native marketplace install), Cursor (mcp.json snippet), Smithery (smithery mcp add favcrm/favcrm). OAuth-based clients pending review: Claude Connectors (Anthropic), ChatGPT Apps Directory (OpenAI). Same Bearer-token shape works on Windsurf, Continue.dev, Zed, Cline, Roo Code, Replit Agent.
Q.06 What playbooks does FavCRM expose?
37 named playbooks (MCP prompts) covering customer onboarding, loyalty, full booking lifecycle, billing, subscriptions, segmentation, comms, content, sales pipeline, ops, AI-knowledge training, and reporting. Examples: /book-customer, /add-loyalty-points, /chase-overdue-invoices, /train-ai-agent. Clients render them as slash commands or workflow buttons.
Q.07 Where is FavCRM hosted and what about data residency?
Cloudflare D1 + Workers, primary region Hong Kong (HKG). PDPO-aligned for HK merchants. Edge runtime means cold-start <50ms globally. Data residency for non-HK merchants honours Cloudflare D1 region pinning where supported.
Q.08 Can I self-host the FavCRM MCP server?
No. The server is proprietary FavCRM SaaS. The public examples + install snippets at github.com/favcrm/mcp are MIT-licensed; the server endpoint at api.favcrm.io/mcp is hosted only. Same applies to the Vercel marketplace install — installing via Marketplace creates a workspace on FavCRM's infrastructure.

Pick a platform.
Or wire your own.

The protocol is open. The repo is public. The endpoint is one curl away.