API & Agents overview

Offering bots to customers from an enterprise application? See the separate API Vendor guide for customer authorization and sponsored bots.

Authentication

Create a token in Dashboard → API & Agents. Tokens are scoped, can be limited to specific bots, and can expire. The token secret is shown once. Only workspace owners and admins can manage tokens or approve MCP OAuth access. Pass a token as a bearer header:

curl https://api.dev-moncha.com/v1/bots \
  -H "Authorization: Bearer mgpt_your_token_here"

REST and MCP access requires API access on an active paid Growth or higher plan, or an active Growth trial. Enterprise contracts must include API access. Tokens and OAuth connections stop working while the workspace is not live; restoring access does not require replacing the token.

Endpoints

Full schemas: openapi.json

A token restricted to specific bots must pass an allowed chatbotId for knowledge, chat, leads and analytics requests. Bot-restricted tokens cannot create bots. Enterprise bot creation requires enterprise_plan_tier (starter, growth or scale) and an available slot of that tier. Knowledge ingestion checks the bot's page quota before queuing.

Chat (streaming)

POST /v1/chat returns Server-Sent Events with OpenAI-style chunks. Pass a stable sessionId to group turns into one conversation.

curl https://api.dev-moncha.com/v1/chat \
  -H "Authorization: Bearer mgpt_…" \
  -H "Content-Type: application/json" \
  -d '{"message":"What is your refund policy?","chatbotId":"…","sessionId":"user-42","language":"ja-JP"}'

Bookings

List appointment requests and confirm, reject, reschedule, or cancel them. Confirming emails the visitor and blocks that slot. Reschedule needs requestedSlot (ISO-8601 with offset) and emails the new time. Cancel emails the visitor. Same behaviour as the Bookings page. Scopes: bookings:read / bookings:write.

curl https://api.dev-moncha.com/v1/bookings?status=pending \
  -H "Authorization: Bearer mgpt_…"

curl https://api.dev-moncha.com/v1/bookings/BOOKING_ID \
  -X PATCH \
  -H "Authorization: Bearer mgpt_…" \
  -H "Content-Type: application/json" \
  -d '{"action":"confirm"}'

curl https://api.dev-moncha.com/v1/bookings/BOOKING_ID \
  -X PATCH \
  -H "Authorization: Bearer mgpt_…" \
  -H "Content-Type: application/json" \
  -d '{"action":"reschedule","requestedSlot":"2026-08-20T15:00:00+05:30"}'

curl https://api.dev-moncha.com/v1/bookings/BOOKING_ID \
  -X PATCH \
  -H "Authorization: Bearer mgpt_…" \
  -H "Content-Type: application/json" \
  -d '{"action":"cancel","cancelComment":"We need to close that day."}'

MCP server (for AI agents)

MonCha hosts a remote MCP server, so Claude and other MCP-capable agents can list bots, add knowledge, ask questions, read conversations, leads & analytics, and list / confirm / reject / reschedule / cancel bookings. Connect through user-approved OAuth or a scoped API token. Tools: list_bots, list_knowledge, add_knowledge, ask_bot, list_conversations, get_conversation, list_leads, get_analytics, list_bookings, get_booking, update_booking.

{
  "mcpServers": {
    "MonCha": {
      "url": "https://api.dev-moncha.com/mcp",
      "headers": { "Authorization": "Bearer mgpt_…" }
    }
  }
}