Model Context Protocol (MCP) Server
The Pynath Booking MCP Server enables AI agents (Claude Desktop, Cursor, LangChain, or custom autonomous agents) to query live availability, inspect service catalogs, and schedule appointments on behalf of users.
1. Quick Configuration for Claude Desktop / Cursor
Add the following block to your claude_desktop_config.json or Cursor MCP settings file:
{
"mcpServers": {
"pynath-booking": {
"command": "npx",
"args": ["-y", "@pynath/mcp-server"],
"env": {
"PYNATH_API_KEY": "pyn_live_your_secret_api_key"
}
}
}
}2. Exposed MCP Tools
Agents can autonomously invoke these tools when connected to your private Pynath Booking instance.
list_servicesReturns active services, durations, and pricing in your booking catalog.
Input Schema
{
"type": "object",
"properties": {
"active": { "type": "boolean", "default": true }
}
}Output Response Envelope
{
"services": [
{ "id": "srv-001", "name": "Initial Consultation", "durationMin": 30, "price": 0, "currency": "INR" },
{ "id": "srv-002", "name": "Haircut & Styling", "durationMin": 45, "price": 800, "currency": "INR" }
]
}check_availabilityChecks open time slots for a given date (YYYY-MM-DD) across team calendars.
Input Schema
{
"type": "object",
"required": ["date"],
"properties": {
"date": { "type": "string", "format": "date", "description": "Date formatted as YYYY-MM-DD" },
"serviceId": { "type": "string", "format": "uuid", "description": "Optional service filter" }
}
}Output Response Envelope
{
"date": "2026-08-10",
"availableSlots": ["09:00", "10:30", "14:00", "16:15"],
"timezone": "UTC"
}create_bookingBooks an appointment for a service with customer metadata and returns confirmation.
Input Schema
{
"type": "object",
"required": ["serviceId", "customerName", "customerEmail", "startTime", "endTime"],
"properties": {
"serviceId": { "type": "string", "format": "uuid" },
"customerName": { "type": "string" },
"customerEmail": { "type": "string", "format": "email" },
"customerPhone": { "type": "string" },
"startTime": { "type": "string", "format": "date-time" },
"endTime": { "type": "string", "format": "date-time" },
"notes": { "type": "string" }
}
}Output Response Envelope
{
"id": "bk_81a72b3c4d5e",
"status": "CONFIRMED",
"customerName": "Elena Rostova",
"startTime": "2026-08-10T14:00:00Z"
}3. Autonomous Agent Discovery Manifests
AI agents can discover Pynath tools and service capabilities via standardized machine-readable discovery endpoints: