Gorelo MCP server

Gorelo MCP Server

MCP server for Gorelo's PSA (Professional Services Automation) REST API - ticket, client, contact, contract, asset, and time-tracking visibility - for AI assistants and the WYRE Conduit gateway.

Authentication

Generate an API key for your Gorelo organization and send it as the X-API-Key header - this server handles that on every request. There is no token exchange.

Configuration

Tools

Tickets

• gorelolisttickets - list tickets, filterable by status/client/priority/type/assignee/contact/tag/group/keyword/date range.
• gorelogetticket - get a single ticket's full detail.
• gorelolistticket_statuses - list configured ticket statuses.
• gorelolistticket_tags - list configured ticket tags.
• gorelolistticket_types - list configured ticket types.
• gorelolistticket_comments - list comments on a ticket.
• gorelogetticket_comment - get a single comment on a ticket.
• gorelolistticket_conversations - list a ticket's main thread, side conversations, and approvals.
• gorelogetticket_approval - get a single approval's status and approvers.

Clients

• gorelolistclients - list clients.
• gorelogetclient - get a single client.
• gorelolistclient_locations - list a client's locations.

Contacts

• gorelolistcontacts - list contacts, optionally filtered by client.
• gorelogetcontact - get a single contact.

Contracts

• gorelolistcontracts - list billing contracts and their service lines.

Assets

• gorelolistassets - list agent (managed device) assets.
• gorelogetasset - get a single agent asset.
• gorelolistcustom_assets - list custom (non-agent) assets.

Time Tracking

• gorelolisttime_entries - list logged time across tickets and tasks.
• gorelogettime_entry - get a single time entry.
• gorelolistbilling_roles - list configured billing roles.
• gorelolistwork_types - list configured work types.

Organization

• gorelolistusers - list users (technicians).
• gorelolistgroups - list technician groups.

Scope

This is a v1 read-only surface: every tool is a GET against Gorelo's Public API. Every write action (creating or updating tickets/comments/clients/contacts/time entries, posting external alerts, uploading attachments, and all delete endpoints) is out of scope for this release and can be added as a follow-up once there's a concrete need for it.

GET /v1/invoices/{id}/pdf is also out of scope: it returns a binary PDF rather than JSON, and this wave's connectors treat binary report/document endpoints as a separate concern from structured data visibility.

Development

npm install
npm run build
npm test
npm run lint   # tsc --noEmit

Docker

docker build -t gorelo-mcp .
docker run -p 8080:8080 \
  -e GORELO_API_KEY=... \
  gorelo-mcp