PluginBench
MCP Server

HaloPSA MCP Server

io.github.wyre-technology/halopsa-mcp

RepositoryRegistry

What is the HaloPSA MCP server?

MCP server for HaloPSA — clients, tickets, and PSA workflows via the HaloPSA REST API.

How to install HaloPSA

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • HALOPSA_CLIENT_ID
    required

    HaloPSA OAuth client ID

  • HALOPSA_CLIENT_SECRET
    required
    secret

    HaloPSA OAuth client secret

  • HALOPSA_TENANT

    HaloPSA tenant identifier (subdomain). Provide this or HALOPSA_BASE_URL.

  • HALOPSA_BASE_URL

    HaloPSA base URL (e.g. https://your-instance.halopsa.com). Provide this or HALOPSA_TENANT.

  • MCP_TRANSPORT

    Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.

  • AUTH_MODE

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

  • LOG_LEVEL

    Log verbosity: debug, info, warn, error

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "halopsa-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/halopsa-mcp:v1.6.0"
      ],
      "env": {
        "HALOPSA_CLIENT_ID": "<YOUR_HALOPSA_CLIENT_ID>",
        "HALOPSA_CLIENT_SECRET": "<YOUR_HALOPSA_CLIENT_SECRET>",
        "HALOPSA_TENANT": "<YOUR_HALOPSA_TENANT>",
        "HALOPSA_BASE_URL": "<YOUR_HALOPSA_BASE_URL>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "AUTH_MODE": "<YOUR_AUTH_MODE>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "halopsa-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/halopsa-mcp:v1.6.0"
      ],
      "env": {
        "HALOPSA_CLIENT_ID": "<YOUR_HALOPSA_CLIENT_ID>",
        "HALOPSA_CLIENT_SECRET": "<YOUR_HALOPSA_CLIENT_SECRET>",
        "HALOPSA_TENANT": "<YOUR_HALOPSA_TENANT>",
        "HALOPSA_BASE_URL": "<YOUR_HALOPSA_BASE_URL>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "AUTH_MODE": "<YOUR_AUTH_MODE>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "halopsa-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/halopsa-mcp:v1.6.0"
      ],
      "env": {
        "HALOPSA_CLIENT_ID": "<YOUR_HALOPSA_CLIENT_ID>",
        "HALOPSA_CLIENT_SECRET": "<YOUR_HALOPSA_CLIENT_SECRET>",
        "HALOPSA_TENANT": "<YOUR_HALOPSA_TENANT>",
        "HALOPSA_BASE_URL": "<YOUR_HALOPSA_BASE_URL>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "AUTH_MODE": "<YOUR_AUTH_MODE>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "halopsa-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/halopsa-mcp:v1.6.0"
      ],
      "env": {
        "HALOPSA_CLIENT_ID": "<YOUR_HALOPSA_CLIENT_ID>",
        "HALOPSA_CLIENT_SECRET": "<YOUR_HALOPSA_CLIENT_SECRET>",
        "HALOPSA_TENANT": "<YOUR_HALOPSA_TENANT>",
        "HALOPSA_BASE_URL": "<YOUR_HALOPSA_BASE_URL>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "AUTH_MODE": "<YOUR_AUTH_MODE>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}
Claude Code
claude mcp add halopsa-mcp --env HALOPSA_CLIENT_ID=<YOUR_HALOPSA_CLIENT_ID> --env HALOPSA_CLIENT_SECRET=<YOUR_HALOPSA_CLIENT_SECRET> --env HALOPSA_TENANT=<YOUR_HALOPSA_TENANT> --env HALOPSA_BASE_URL=<YOUR_HALOPSA_BASE_URL> --env MCP_TRANSPORT=<YOUR_MCP_TRANSPORT> --env AUTH_MODE=<YOUR_AUTH_MODE> --env LOG_LEVEL=<YOUR_LOG_LEVEL> -- docker run -i --rm ghcr.io/wyre-technology/halopsa-mcp:v1.6.0

Related MCP servers

Abnormal Security

MCP server for Abnormal Security — AI-powered email threat detection, cases, and remediation.

View repository →

Action1

Action1 MCP server — endpoint inventory, patch visibility, and policy automation via REST API.

View repository →

Alternative Payments

MCP server for Alternative Payments — customers, invoices, payment requests, payouts, webhooks.

View repository →

Atera

MCP server for Atera RMM — customers, tickets, and more.

View repository →

Autotask

MCP server for Kaseya Autotask PSA — companies, tickets, projects, time entries, and more.

View repository →

Auvik

MCP server for the Auvik network monitoring API — devices, alerts, statistics, billing.

View repository →