CallChatSyn

Official4 tools

by oneappsworld · TypeScript

Answer small-business customer questions from FAQs, list open appointment times, and book them.

com.callchatsyn/callchatsyn MCP Server

This MCP server supports answering small-business customer questions from FAQs, retrieving open appointment times, and booking appointments. It is identified by the name com.callchatsyn/callchatsyn and slug com-callchatsyn/callchatsyn.

🛠️ Key Features

Answers customer questions from FAQs
Lists open appointment times
Books appointments

🚀 Use Cases

Customer support for small businesses using FAQ content
Checking availability and scheduling appointments

⚡ Developer Benefits

Consolidates FAQ Q&A, availability lookup, and booking into one server capability set

⚠️ Limitations

Server data available here does not specify additional tools, parameters, authentication, or supported integrations

Topics

appointmentsbookingchatbotmcpmcp-servermodel-context-protocolsmall-business

Captured live from the server via tools/list.

answer_customer_question

Answer a customer's message for one small business using only that business's own FAQs and order records. Rule-based, not generated, so it never invents prices or opening hours; English and Chinese are detected automatically. Read-only: it never books or changes anything. Use it first for any customer message. If it returns intent 'appointment', call list_open_times next; if matched is false or intent is 'human_handoff', tell the customer a person will follow up. Authenticates with the connection's API key (Authorization: Bearer ccs_live_…); without a key it answers as a public demo business. Returns JSON { intent, lang, matched, reply, next? }.

Parameters1

message

string

required

The customer's message exactly as they wrote it (1-2,000 characters, English or Chinese). Don't rephrase or translate it.

Raw schema

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The customer's message exactly as they wrote it (1-2,000 characters, English or Chinese). Don't rephrase or translate it."
    }
  },
  "required": [
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_open_times

List the business's next open appointment times: up to 5, soonest first, within the next 7 days, labelled in the business's time zone, plus its services and locations. Read-only. Call it before book_appointment and whenever a customer asks when they can come in. Times come from the business's CallChatSyn hours or from its connected Cal.com calendar. Returns JSON { slots: [{ start, label }], services, locations }; pass a slot's 'start' to book_appointment unchanged. An empty slots list means nothing is open this week.

Parameters1

lang

string

optional

Language of the human-readable labels: 'en' (default) or 'zh'. Times themselves are always ISO 8601 UTC.

Raw schema

{
  "type": "object",
  "properties": {
    "lang": {
      "description": "Language of the human-readable labels: 'en' (default) or 'zh'. Times themselves are always ISO 8601 UTC.",
      "type": "string",
      "enum": [
        "en",
        "zh"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

book_appointment

Book one appointment for a customer. This creates a real booking: the business is notified, and if it has connected Cal.com the booking is created there too. With the demo key it's a dry run that books nothing. Not idempotent: booking the same time twice fails the second time. Only call it after the customer has confirmed the time and service; needs a 'start' from list_open_times and the customer's email or phone. Errors: 404 the time is no longer offered (call list_open_times again), 409 it was just taken, 400 missing start, service, or both email and phone, or the business's connected calendar needs a detail the customer didn't give (the message says which, e.g. an email). Returns JSON { booked, id, start, label }; keep 'id' if the customer may want to cancel.

Parameters6

start	string	required	The exact 'start' value returned by list_open_times (ISO 8601 UTC), unchanged.
service	string	required	What the customer is booking; use one of the 'services' returned by list_open_times.
name	string	optional	The customer's name as they gave it; shown to the business.
email	string	optional	The customer's email. Give email or phone (at least one is required).
phone	string	optional	The customer's phone in international format, e.g. +6591234567. Give email or phone (at least one is required).
remarks	string	optional	Optional note for the business, up to 500 characters (e.g. 'first visit').

Raw schema

{
  "type": "object",
  "properties": {
    "start": {
      "type": "string",
      "description": "The exact 'start' value returned by list_open_times (ISO 8601 UTC), unchanged."
    },
    "service": {
      "type": "string",
      "minLength": 1,
      "description": "What the customer is booking; use one of the 'services' returned by list_open_times."
    },
    "name": {
      "description": "The customer's name as they gave it; shown to the business.",
      "type": "string"
    },
    "email": {
      "description": "The customer's email. Give email or phone (at least one is required).",
      "type": "string"
    },
    "phone": {
      "description": "The customer's phone in international format, e.g. +6591234567. Give email or phone (at least one is required).",
      "type": "string"
    },
    "remarks": {
      "description": "Optional note for the business, up to 500 characters (e.g. 'first visit').",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "start",
    "service"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_appointment

Cancel one of the business's bookings by the 'id' that book_appointment returned. This changes data: the time becomes free again, and if the business has connected Cal.com the booking is cancelled there too (Cal.com emails the customer). Only call it after the customer has clearly asked to cancel that specific booking. To reschedule, cancel and then book a new time from list_open_times. With the demo key it's a dry run. Errors: 404 no such booking for this business, 409 already cancelled, 400 not a booking id. Returns JSON { cancelled, id, start }.

Parameters1

string

required

The booking 'id' returned by book_appointment (a UUID).

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The booking 'id' returned by book_appointment (a UUID)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md2 KBView on GitHub

CallChatSyn MCP server

Let an AI assistant (Claude, Cursor, any MCP client) answer customer questions and book appointments for a small business, using that business's own FAQs and opening hours on CallChatSyn.

Free for the first 1,000 businesses (founder offer: 100 API calls a day, 2,000 a month).

Tools

Tool	Changes data?	What it does
`answer_customer_question`	No (read-only)	Answers from the business's FAQs and order data (English/Chinese); flags booking and "talk to a person" requests
`list_open_times`	No (read-only)	Next open times (up to 5, next 7 days) in the business's time zone, plus services and locations; from CallChatSyn hours or the business's connected Cal.com
`book_appointment`	Yes, creates a booking	Books one of those times and returns its `id`; the business is notified and, with Cal.com connected, the booking is created there. Not idempotent. Demo key = dry run
`cancel_appointment`	Yes, cancels a booking	Cancels a booking by `id` (also in Cal.com if connected). To reschedule: cancel, then book a new time. Demo key = dry run

Remote server (nothing to install)

Add this URL as a custom connector (Claude: Settings → Connectors → Add custom connector; Cursor and others: a Streamable HTTP server):

code

https://callchatsyn.com/api/mcp

Without a key it uses the demo business. To act for your own business, send the header Authorization: Bearer ccs_live_.... Also listed in the official MCP Registry as com.callchatsyn/callchatsyn.

Local setup (npx)

Create a CallChatSyn account, add FAQs and opening hours, then Dashboard → Developers → claim founder access → create an API key.
Add to your MCP client config:

json

{
  "mcpServers": {
    "callchatsyn": {
      "command": "npx",
      "args": ["-y", "github:oneappsworld/callchatsyn-mcp"],
      "env": { "CALLCHATSYN_API_KEY": "ccs_live_..." }
    }
  }
}

Keep the key private; it acts for one business.

No key yet? Leave CALLCHATSYN_API_KEY out and the server uses the public demo key (ccs_demo_public): answers come from a demo business and bookings are dry runs, so you can try every tool before signing up.

Notes

Answers are rule-based FAQ matching (fast, predictable), not free-form generation.
API docs and OpenAPI spec: https://callchatsyn.com/developers · https://callchatsyn.com/openapi.json

MIT licensed.

Install

Tools (4)

answer_customer_questionlist_open_timesbook_appointmentcancel_appointment

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://callchatsyn.com/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "callchatsyn": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://callchatsyn.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

com.callchatsyn/callchatsyn MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

answer_customer_question

list_open_times

book_appointment

cancel_appointment

CallChatSyn MCP server

Tools

Remote server (nothing to install)

Local setup (npx)

Notes

Install

Remote endpoint

Related servers