How do I install Afkbot?

Afkbot is a local plugin. Install it using the provided package and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Afkbot safe to use?

Afkbot scored 5.3/10 (moderate risk) in MCP Marketplace's automated security scan. It has 2 high or critical findings to review. It's listed, but review the security report on this page before installing.

What credentials does Afkbot need?

Afkbot requires the following credentials or environment variables: AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AFKBOT_API_URL, AFKBOT_APP_CLIENT_ID, MCP_TRANSPORT, AUTH_MODE, LOG_LEVEL. You can find setup instructions on the server detail page.

What AI apps work with Afkbot?

Afkbot uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Afkbot MCP Server

by Wyre Technology

Developer ToolsModerate5.3MCP RegistryLocal

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 Risk

AFKBot 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.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Azure AD tenant ID hosting the AFKBot app registrationOptional

Environment variable: AZURE_TENANT_ID

Client ID of the app registration used to authenticate to AFKBotOptional

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 omittedOptional

Environment variable: AFKBOT_API_URL

AFKBot Easy Auth app client ID (audience) — defaults to productionOptional

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.Optional

Environment variable: MCP_TRANSPORT

Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.Optional

Environment variable: AUTH_MODE

Log verbosity: debug, info, warn, errorOptional

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 GitHub

From 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

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Afkbot MCP Server

About

Security Report

Findings (7)Action required

Permissions Required

What You'll Need

How to Install

Documentation

afkbot-mcp

Architecture

Quick Start

Environment Variables

Run Locally

Run with Docker

Claude Desktop / Claude Code Config

Available Tools

create_pto_request

list_pto_requests

get_pto_request

cancel_pto_request

team_calendar

Auth Setup

WYRE Ecosystem

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MCP Marketplace

MarkItDown

`create_pto_request`

`list_pto_requests`

`get_pto_request`

`cancel_pto_request`

`team_calendar`