wyre-technology avatar

HaloPSA

wyre-technology/halopsa-mcp

Connects to HaloPSA's REST API with OAuth 2.0 credentials to manage PSA workflows. Uses a decision tree architecture where you start with a navigation tool, select a domain (tickets, clients, assets, agents, or invoices), then get domain-specific operations loaded on demand. For tickets you can list, create, update, and add actions. Clients and assets support CRUD and search. Agents and invoices are read-only. The hierarchical loading keeps the initial tool set small instead of exposing everything upfront. Reach for this if you're running a service desk on HaloPSA and want Claude to query ticket status, create client records, or look up asset configurations without switching contexts.

GitHub stars
3
tools
23
auth
Secret needed
transport
STDIO
env vars
7
last updated
Aug 21, 2026

Tools

23 tools

Public tool metadata for what this MCP can expose to an agent.

halopsa_navigateSelect a domain to work with

Select a domain to work with

No parameter schema in public metadata yet.

halopsa_statusShow current state and credential status

Show current state and credential status

No parameter schema in public metadata yet.

halopsa_backReturn to main menu (when in a domain)

Return to main menu (when in a domain)

No parameter schema in public metadata yet.

halopsa_tickets_listList tickets with filters (category_1 only; category_2–category_4 are rejected)

List tickets with filters (category_1 only; category_2–category_4 are rejected)

No parameter schema in public metadata yet.

halopsa_tickets_getGet ticket details

Get ticket details

No parameter schema in public metadata yet.

halopsa_tickets_createCreate a new ticket (optional category_1–category_4)

Create a new ticket (optional category_1–category_4)

No parameter schema in public metadata yet.

halopsa_tickets_updateUpdate an existing ticket (optional category_1–category_4)

Update an existing ticket (optional category_1–category_4)

No parameter schema in public metadata yet.

halopsa_tickets_add_actionAdd a note/action to a ticket

Add a note/action to a ticket

No parameter schema in public metadata yet.

halopsa_categories_listList one page of ticket categories (limit defaults to 50; page_no starts at 1)

List one page of ticket categories (limit defaults to 50; page_no starts at 1)

No parameter schema in public metadata yet.

halopsa_categories_getGet a category by ID

Get a category by ID

No parameter schema in public metadata yet.

halopsa_clients_listList clients

List clients

No parameter schema in public metadata yet.

halopsa_clients_getGet client details

Get client details

No parameter schema in public metadata yet.

halopsa_clients_createCreate a new client

Create a new client

No parameter schema in public metadata yet.

halopsa_clients_searchSearch clients by name

Search clients by name

No parameter schema in public metadata yet.

halopsa_assets_listList assets with filters

List assets with filters

No parameter schema in public metadata yet.

halopsa_assets_getGet asset details

Get asset details

No parameter schema in public metadata yet.

halopsa_assets_searchSearch assets

Search assets

No parameter schema in public metadata yet.

halopsa_assets_list_typesList available asset types

List available asset types

No parameter schema in public metadata yet.

halopsa_agents_listList agents/technicians

List agents/technicians

No parameter schema in public metadata yet.

halopsa_agents_getGet agent details

Get agent details

No parameter schema in public metadata yet.

halopsa_teams_listList teams

List teams

No parameter schema in public metadata yet.

halopsa_invoices_listList invoices with filters

List invoices with filters

No parameter schema in public metadata yet.

halopsa_invoices_getGet invoice details

Get invoice details

No parameter schema in public metadata yet.

Sponsors

Configuration

HALOPSA_CLIENT_ID*

HaloPSA OAuth client ID

HALOPSA_CLIENT_SECRET*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_TRANSPORTdefault: stdio

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

AUTH_MODEdefault: env

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

LOG_LEVELdefault: info

Log verbosity: debug, info, warn, error

Readme

HaloPSA MCP Server

A Model Context Protocol (MCP) server for interacting with HaloPSA, featuring a decision tree architecture for efficient tool loading.

One-Click Deployment


View the full README on GitHub

Details

Repository
github.com/wyre-technology/halopsa-mcp
Website
github.com/wyre-technology/halopsa-mcp
Package
ghcr.io/wyre-technology/halopsa-mcp:v1.7.11
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from wyre-technology