API & MCP reference

Everything the dashboard does, as a REST API — plus a hosted MCP server so AI agents like Claude can manage your bots directly. Available on the Growth plan and higher.

Authentication

Create a token in Dashboard → API. Tokens are scoped, can be limited to specific bots, and can expire. Pass them as a bearer header:

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

Endpoints

Method	Path	Scope	Description
GET	/v1/bots	bots:read	List bots
POST	/v1/bots	bots:write	Create a bot (plan-limited)
GET	/v1/kb?chatbotId=…	kb:read	List knowledge-base documents
POST	/v1/kb/ingest	kb:write	Add knowledge from a URL or raw text (queued)
POST	/v1/chat	chat:invoke	Chat with a bot — SSE streaming, counts toward quota
GET	/v1/conversations	conversations:read	List conversations (?q= search)
GET	/v1/conversations/{sessionId}	conversations:read	Full transcript of one session
GET	/v1/leads	leads:read	List intent-scored leads (?chatbotId= filter)
GET	/v1/analytics	analytics:read	30-day analytics summary
GET	/v1/bookings	bookings:read	List appointment requests (?status= pending\|confirmed\|rejected\|cancelled)
GET	/v1/bookings/{id}	bookings:read	One booking — visitor, slot, status
PATCH	/v1/bookings/{id}	bookings:write	Confirm, reject, reschedule, or cancel — emails the visitor
GET	/v1/openapi.json	—	This API as an OpenAPI 3.1 spec (no auth)

Full schemas: openapi.json

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 — using the same scoped tokens. 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_…" }
    }
  }
}

Get an API key in 2 minutes

Start the free trial, open Dashboard → API & Agents, create a token.

Start free trial

Something unclear? Tell us.

Start free trial