Back to Browse
Free
Server data from the Official MCP Registry
MCP server for AFKBot PTO management — file, list, and cancel time-off requests.
About
MCP server for AFKBot PTO management — file, list, and cancel time-off requests.
Security Report
5.3
Moderate5.3Moderate RiskAFKBot MCP server is well-structured with proper authentication via Azure AD client credentials and appropriate scope of permissions. The server implements secure token handling with caching and expiration logic. Minor code quality issues exist around input validation and error handling, but these do not constitute security vulnerabilities. Permissions (network_http, env_vars) align appropriately with the server's purpose as a PTO management integration tool. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity).
7 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Azure AD tenant ID hosting the AFKBot app registration
Environment variable: AZURE_TENANT_ID
Client ID of the app registration used to authenticate to AFKBot
Environment variable: AZURE_CLIENT_ID
Client secret for the AFKBot app registrationRequired
Environment variable: AZURE_CLIENT_SECRET
AFKBot API base URL — defaults to the production endpoint if omitted
Environment variable: AFKBOT_API_URL
AFKBot Easy Auth app client ID (audience) — defaults to production
Environment variable: AFKBOT_APP_CLIENT_ID
Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.
Environment variable: MCP_TRANSPORT
Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.
Environment variable: AUTH_MODE
Log verbosity: debug, info, warn, error
Environment variable: LOG_LEVEL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-wyre-technology-afkbot-mcp": {
"env": {
"AUTH_MODE": "your-auth-mode-here",
"LOG_LEVEL": "your-log-level-here",
"MCP_TRANSPORT": "your-mcp-transport-here",
"AFKBOT_API_URL": "your-afkbot-api-url-here",
"AZURE_CLIENT_ID": "your-azure-client-id-here",
"AZURE_TENANT_ID": "your-azure-tenant-id-here",
"AZURE_CLIENT_SECRET": "your-azure-client-secret-here",
"AFKBOT_APP_CLIENT_ID": "your-afkbot-app-client-id-here"
},
"args": [
"-y",
"afkbot-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
afkbot-mcp
MCP server for AFKBot PTO management — file time-off requests from any MCP client.
Architecture
┌──────────────┐ stdio ┌──────────────┐ HTTPS ┌──────────────┐
│ MCP Client │◄──────────────►│ afkbot-mcp │◄────────────►│ AFKBot API │
│ (Claude, etc)│ │ MCP Server │ Bearer JWT │ (Azure ACA) │
└──────────────┘ └──────────────┘ └──────┬───────┘
│
┌────────┬───────┼────────┐
│ │ │ │
Float Outlook Autotask Rootly
AFKBot orchestrates PTO requests across Float, Outlook Calendar, Autotask, and Rootly. This MCP server wraps its REST API so any MCP-compatible client can file and manage time-off requests.
Quick Start
Environment Variables
| Variable | Required | Description |
|---|---|---|
AZURE_TENANT_ID | Yes | Azure AD tenant ID (d92c73a4-ccc2-4277-8c5d-73c2849adfa4) |
AZURE_CLIENT_ID | Yes | Your MCP server's app registration client ID |
AZURE_CLIENT_SECRET | Yes | Your MCP server's app registration client secret |
AFKBOT_API_URL | No | AFKBot API URL (defaults to production) |
AFKBOT_APP_CLIENT_ID | No | AFKBot Easy Auth client ID (defaults to production) |
Run Locally
npm ci
npm run build
node dist/index.js
Run with Docker
docker compose up --build
Claude Desktop / Claude Code Config
{
"mcpServers": {
"afkbot": {
"command": "node",
"args": ["/path/to/afkbot-mcp/dist/index.js"],
"env": {
"AZURE_TENANT_ID": "d92c73a4-ccc2-4277-8c5d-73c2849adfa4",
"AZURE_CLIENT_ID": "your-app-client-id",
"AZURE_CLIENT_SECRET": "your-app-client-secret"
}
}
}
}
Available Tools
create_pto_request
File a new PTO request.
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_email | string | Yes | Employee email address |
request_type | string | Yes | full_day or partial_day |
start_date | string | Yes | Start date (YYYY-MM-DD) |
end_date | string | No | End date (defaults to start_date) |
start_time | string | No | Start time for partial day (HH:MM) |
end_time | string | No | End time for partial day (HH:MM) |
details | string | No | Reason or notes |
list_pto_requests
List PTO requests with optional filters.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | pending, approved, declined, or all |
employee_email | string | No | Filter by employee |
limit | number | No | Max results (default: 25) |
offset | number | No | Pagination offset |
get_pto_request
Get details of a specific request.
| Parameter | Type | Required | Description |
|---|---|---|---|
request_id | string | Yes | The PTO request ID |
cancel_pto_request
Cancel a pending or approved request.
| Parameter | Type | Required | Description |
|---|---|---|---|
request_id | string | Yes | The PTO request ID |
reason | string | No | Reason for cancellation |
team_calendar
View who's out on a given date range.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_date | string | Yes | Start date (YYYY-MM-DD) |
end_date | string | No | End date (defaults to start_date) |
Auth Setup
This MCP server authenticates to AFKBot using Azure AD client credentials. You need to create an app registration:
-
Create an App Registration in Azure AD (Entra ID)
- Go to Azure Portal → Entra ID → App registrations → New registration
- Name:
afkbot-mcp(or your choice) - Supported account types: Single tenant
-
Create a Client Secret
- In the app registration → Certificates & secrets → New client secret
- Copy the secret value
-
Grant API Permissions
- In the app registration → API permissions → Add a permission
- Select "APIs my organization uses" → search for AFKBot (
17963178-bee5-4738-82a3-088e739bb95b) - Add the appropriate permissions
- Grant admin consent
-
Set Environment Variables using the values from the app registration
WYRE Ecosystem
This is part of the WYRE Technology MCP server suite:
- autotask-mcp — Kaseya Autotask PSA integration
- afkbot-mcp (this repo) — PTO management via AFKBot
License
MIT — Copyright (c) 2025 Aaron Sachs
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
80.0K
Stars
4
Installs
5.3
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
508
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
68
Installs
10.0
Security
4.6
Local