# agendapro-mcp

MCP server for [AgendaPro](https://agendapro.com/). It lets an AI assistant (Claude Desktop, Claude Code, Cursor or any MCP host) check free slots, find clients and create, move or cancel bookings, through the official AgendaPro API v3.

## Tools

| Tool | What it does |
|---|---|
| `list_locations` | Business locations |
| `list_services` | Bookable services, with duration and price |
| `list_providers` | Active staff, by location or service |
| `get_available_slots` | Free slots on a day at a location |
| `search_clients` | Find a client by name, email, phone or ID number |
| `create_client` | Create a client |
| `list_bookings` | Bookings by client, location, provider or dates |
| `create_booking` | Book a free slot |
| `reschedule_booking` | Move a booking |
| `cancel_booking` | Cancel a booking (marked as destructive, so hosts ask before running it) |

## Setup

Create an API key in AgendaPro (**Settings > Integrations**). Then add the server to your MCP host, for example in Claude Desktop's `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "agendapro": {
      "command": "npx",
      "args": ["-y", "agendapro-mcp"],
      "env": { "AGENDAPRO_API_KEY": "apk_live_..." }
    }
  }
}
```

The key stays on your machine and is only sent to AgendaPro.

## Compatibility

Tested through a real MCP client over stdio against a mock that checks every request against the official AgendaPro OpenAPI definitions. Not yet tested against a live AgendaPro account.

## Development

```bash
npm install
npm run fetch-spec   # downloads the official API definitions used by the tests
npm test
```

## License

MIT