Overview

What is BookYourPTO MCP?

BookYourPTO MCP is a hosted server that gives AI tools secure access to your BookYourPTO workspace. Built on the Model Context Protocol (MCP) open standard, it lets AI assistants — Claude.ai connectors, Claude Code, Claude Desktop, Cursor, VS Code Copilot, and more — interact with your HR data through natural language.

How It Works

┌─────────────────┐  Streamable HTTP  ┌──────────────────┐      REST API     ┌──────────────────┐
│   AI Client     │ ◄──────────────►  │  BookYourPTO MCP │ ◄───────────────► │  BookYourPTO API │
│ (Claude.ai,     │   POST /mcp       │  Server (hosted) │   Authenticated   │  (app.bookyourpto│
│  Cursor, Code…) │   Tool calls      │  mcp.bookyourpto │   API requests    │  .com)           │
└─────────────────┘                   │  .com            │                   └──────────────────┘
                                      └──────────────────┘

1. Your AI client connects to https://mcp.bookyourpto.com/mcp using Streamable HTTP (MCP spec 2025-11-25)
2. The MCP server prompts you to sign in via your browser (OAuth 2.0 with PKCE) — your password never touches the AI
3. When the AI needs to take an action (e.g., check leave balance), it calls the appropriate MCP tool
4. The MCP server makes authenticated API requests to BookYourPTO on your behalf
5. Results are returned to the AI client, which formats them into a natural response

What Can You Do?

With BookYourPTO MCP, your AI assistant can:

• Manage leaves — Check balances, submit requests, approve/reject, group-book team leave
• Track time — Clock in/out, manage breaks, query and edit time entries
• Handle expenses — Create, submit, approve/reject, mark paid, manage receipts and per diems
• Run schedules — View, create, and publish shifts
• Manage projects — Projects, tasks, members, and time stats
• HR records — Compensation, certifications, visas, assets, onboarding/offboarding
• Performance — Review cycles, goals, and 1:1s
• Training & benefits — Courses, assignments, plans, and enrollments
• Documents — E-signature send, templates, bulk send, audit trail
• Admin — Org settings, security/audit logs, billing, QuickBooks, auth/2FA, GDPR
• Reports & org info — Leave/timesheet reports, team directory, departments, holidays, dashboard stats

Available Tools

BookYourPTO MCP provides 346 tools across 19 categories:

See the Tools Reference for complete documentation of every tool and its parameters.

Resources

The MCP server exposes read-only resources that give AI clients cached context without a tool call (12 total):

Prompts (slash commands)

The server also ships 10 prebuilt prompts — multi-step workflows your client surfaces as slash commands:

onboard-employee · offboard-employee · expiring-credentials · plan-team-capacity · expense-month-end-close · quarterly-performance-review · training-compliance-check · send-handbook-to-new-hires · audit-report · security-incident-response

Requirements

• A BookYourPTO Cloud account (Pro, Business, or Enterprise plan)
• An MCP-compatible AI client (see Connecting)
• Your BookYourPTO credentials (you'll sign in via your browser when first connecting)