\n Connect any AI agent to Coordinalo's scheduling platform via MCP\n
\n\n
\n \n \n \n
\n\n---\n\n**Coordinalo** is a booking and scheduling SaaS platform. This repository is the official documentation and integration guide for connecting AI agents to Coordinalo via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).\n\n> Coordinalo implements the **Servicialo** open protocol. Any Servicialo-compatible MCP client works out of the box. See [Built on Servicialo](#built-on-servicialo).\n\n## Quick Connect\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"coordinalo\": {\n \"url\": \"https://coordinalo.com/api/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\",\n \"X-Org-Slug\": \"your-org-slug\"\n }\n }\n }\n}\n```\n\nSee [examples/claude-desktop.json](./examples/claude-desktop.json) for a ready-to-paste config.\n\n### Cursor IDE\n\nAdd to your Cursor MCP settings:\n\n```json\n{\n \"mcpServers\": {\n \"coordinalo\": {\n \"url\": \"https://coordinalo.com/api/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\",\n \"X-Org-Slug\": \"your-org-slug\"\n }\n }\n }\n}\n```\n\nSee [examples/cursor-mcp.json](./examples/cursor-mcp.json).\n\n### Any MCP Client\n\nPoint your MCP client to:\n\n```\nEndpoint: https://coordinalo.com/api/mcp\nAuth: Authorization: Bearer \nHeader: X-Org-Slug: \n```\n\n## Authentication\n\nEvery request requires:\n\n| Header | Value | Description |\n| --------------- | -------------------------- | ---------------------------------------- |\n| `Authorization` | `Bearer ` | Your API key from coordinalo.com |\n| `X-Org-Slug` | `your-org-slug` | Your organization identifier |\n\nGet your API key at [coordinalo.com/settings/api](https://coordinalo.com/settings/api). See [docs/authentication.md](./docs/authentication.md) for full details.\n\n## Tool Summary\n\n| Tool | Description | Key Params |\n| ------------------------- | ------------------------------------------ | ---------------------------------------------------- |\n| `availability_get_slots` | Query free slots for a provider/service | `orgSlug`, `providerId?`, `serviceId?`, `dateFrom`, `dateTo` |\n| `booking_create` | Create a new session/appointment | `orgSlug`, `providerId`, `serviceId`, `clientId`, `scheduledAt` |\n| `booking_list` | List sessions with filters | `orgSlug`, `status?`, `providerId?`, `dateFrom?`, `dateTo?` |\n| `booking_get` | Get a single booking's details | `orgSlug`, `sessionId` |\n| `booking_reschedule` | Move a booking to a new time | `orgSlug`, `sessionId`, `newScheduledAt`, `confirm` |\n| `booking_cancel` | Cancel a session | `orgSlug`, `sessionId`, `reason`, `confirm` |\n| `client_list` | List organization clients | `orgSlug`, `search?` |\n| `client_get` | Get client details | `orgSlug`, `clientId` |\n| `client_create` | Create a new client | `orgSlug`, `name`, `lastName`, `email?`, `phone?` |\n| `admin_list_providers` | List active providers | `orgSlug` |\n| `service_list` | List bookable services | `orgSlug` |\n| `report_dashboard` | Get org summary metrics | `orgSlug`, `date?` |\n\nSee [docs/tools.md](./docs/tools.md) for full parameter docs, response formats, and examples.\n\n## Documentation\n\n- **[Quickstart](./docs/quickstart.md)** — Connect and make your first booking in 5 minutes\n- **[Tool Catalog](./docs/tools.md)** — Full reference for every available tool\n- **[Authentication](./docs/authentication.md)** — API keys, org slugs, and auth flow\n- **[Use Cases](./docs/use-cases.md)** — Real-world agent integration patterns\n\n## Examples\n\n- [`claude-desktop.json`](./examples/claude-desktop.json) — Claude Desktop MCP config\n- [`cursor-mcp.json`](./examples/cursor-mcp.json) — Cursor IDE MCP config\n- [`booking-agent.js`](./examples/booking-agent.js) — Node.js autonomous booking flow\n- [`availability-check.py`](./examples/availability-check.py) — Python availability checker\n\n## Built on Servicialo\n\nCoordinalo implements the [Servicialo](https://github.com/servicialo/mcp-server) open protocol — an open-source MCP server specification for service scheduling platforms. This means:\n\n- **Any Servicialo-compatible client** works with Coordinalo without modification\n- **Tool names and parameters** follow the Servicialo spec\n- **Other platforms** implementing Servicialo share the same interface, so your agent code is portable\n\nThe `@servicialo/mcp-server` npm package defines the protocol. Coordinalo hosts a production instance at `https://coordinalo.com/api/mcp`.\n\n## Community & Support\n\n- **Issues** — [GitHub Issues](https://github.com/coordinalo/coordinalo-mcp/issues) for bugs and feature requests\n- **Tool Requests** — Use the [tool request template](./.github/ISSUE_TEMPLATE/tool-request.md) to propose new MCP tools\n- **Website** — [coordinalo.com](https://coordinalo.com)\n- **Servicialo Protocol** — [github.com/servicialo/mcp-server](https://github.com/servicialo/mcp-server)\n\n## License\n\n[Apache 2.0](./LICENSE)\n",
"bytes": 6396,
"sha": "97bbb6933fe2f35c904e6b4206b66eca64215e1709c2245aa278b09767fe118c",
"repo_slug": "danioni/coordinalo-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_com_coordinalo_mcp_server_ba3288bb/readme"
}
![\"Coordinalo\"](\"https://coordinalo.com/logo.png\"){kind=logo}
\n![\"npm](\"https://img.shields.io/npm/v/@servicialo/mcp-server?label=%40servicialo%2Fmcp-server&color=blue\")
![\"Apache](\"https://img.shields.io/badge/license-Apache--2.0-blue\"){kind=icon}
![\"Status:](\"https://img.shields.io/badge/status-Production-brightgreen\"){kind=icon}