Connect Gorelo

Written By Christopher Scaminaci

Last updated 6 days ago

Gorelo is a cloud RMM + PSA platform for MSPs — remote monitoring and management of endpoints alongside a ticketing/CRM system for clients, contacts, and alerts. Connecting Gorelo to StackJack lets your AI assistant work with your Gorelo clients, contacts, RMM agents, and tickets through its public API.

Connecting Gorelo gives your AI a focused set of gorelo_ MCP tools — MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

Look up your clients (companies) and their locations, and the contacts (people) attached to them
Inventory your RMM agent devices and your custom (non-agent) assets, with full detail
Create, update, and delete clients and contacts
Raise alerts against a client
Work tickets end to end — list, read, open, update, and delete them, and read the ticket statuses, tags, and types needed to fill them in
Read and post ticket conversations — comments, side conversations, and approvals, including uploading a file to a ticket
Track time — list, read, log, amend, and delete time entries across tickets and tasks
Read billing setup — billing roles, work types, and contracts, and download an invoice PDF
Resolve your organization's own users and groups (technicians and teams) for ticket assignment

How StackJack authenticates to Gorelo

Gorelo uses an API key sent in the X-API-Key header on every request. Generate it from Settings → Integrations, open the API integration with the cog icon, and choose its permission scope. There is no OAuth or refresh-token flow. Gorelo's public API guide does not publish an automatic-expiration schedule, so plan an intentional replacement and revoke the old key when rotation is complete.

Per-key scopes matter. When you create a key in Gorelo you pick which areas it can touch — contacts, clients, assets, billing, time, alerts, tickets, organization. If a tool returns a 403, it means the key lacks that endpoint's scope, not that your whole account is blocked. Grant the key the areas your AI needs and the 403 goes away.

Regions

Gorelo is region-hosted. StackJack shows a Region dropdown — US (api.usw.gorelo.io) or AU (api.aue.gorelo.io) — that sets the host StackJack calls. Pick the region your Gorelo account lives in. The two regions expose the same tools; only the host differs.

Before you begin

In StackJack: you need a role that can manage connectors (tenant Owner, a co-owner, or an Administrator).
In Gorelo: you need admin access to Settings → Integrations to configure the API integration.
Know your region — US or AU, which you'll select in StackJack.

Step 1 — Create an API key in Gorelo

Sign in to Gorelo as an admin and go to Settings → Integrations.
Click the cog icon for API, then choose Generate New Key.
Enter a descriptive name (for example, "StackJack Integration") and an optional description.
Choose the permission scope the key should grant. Include at least Clients (read) so StackJack's save-time validation can list clients, plus the areas your AI will use.
Click Generate and copy the key.

Step 2 — Add the credentials in StackJack

In the StackJack portal, open Connectors.
Select the Gorelo tile to open its details drawer.
Use How To Connect to review the inline steps, then choose Configure in the drawer footer.
Choose your Region (US or AU). The connection host is set from your choice.
Paste your Gorelo API key and click Save.

What happens when you save

The API key is stored encrypted in Azure Key Vault — never in the StackJack database, and never shown back to you.
If this is the first time you configure Gorelo, a Free-tier subscription for the connector is created automatically so its Free tools work right away.
StackJack immediately live-validates the key by listing clients. The credential remains saved if that upstream check fails so you can correct the region or scope without re-entering every field.
The Configure form collapses while the details drawer stays open. The drawer shows Connected and Valid after success, or Needs Attention with a Re-test action after failure.

Because validation reads your clients, the key needs at least the Clients (read) scope to validate cleanly. A key scoped only to ticket creation can still be valid for that purpose but will report a 403 during save-time validation.

Plans and available tools

See the generated Gorelo tool reference for the current inventory, plan assignment, input schemas, and destructive-action labels.

Gorelo has no per-user sign-in for its API, so all AI traffic authenticates as the single API key — there is no per-user attribution. Current pricing and quotas are shown in the portal's Billing page and at checkout.

Deleting is real, and it is a soft delete. Gorelo's public API does expose delete operations, and StackJack surfaces them as clearly labeled destructive tools. Each one deactivates the record rather than erasing it, so history survives and the record disappears from lists. Two are worth knowing before you ask your AI for one: deleting a ticket also deletes its time entries, and deleting a client or contact is refused outright when other records still depend on it, telling you what is in the way instead of quietly detaching it. The Gorelo web app warns and proceeds in those cases; the API stops. Deleting something already deleted is safe to repeat.

What the Gorelo public API does not expose. There is no way to list or read your uptime checks — your AI can delete one by its ID, but it can only learn that ID from a ticket the check is linked to, or from the Gorelo web app.

Rate limits

Gorelo publishes no numeric API quota. StackJack applies a conservative per-tenant pace (about 120 requests per minute) and honors any 429 backoff, so a long inventory read is usually just slower. Pacing is not a guarantee: retries are bounded, so a wide enough read can still come back throttled or time out. Narrow the read, honour any retry delay the vendor sends, and check whether a write landed before repeating it — see Retrying a failed or timed-out write.

Rotating or replacing the credentials

Create a replacement under Settings → Integrations → API, update the saved key in Gorelo's StackJack details drawer, and choose Re-test. After the replacement works, use Revoke on the old key in the same Gorelo API settings. Revocation is immediate.

Disconnecting Gorelo

Choose Disconnect in the Gorelo details drawer and confirm. StackJack deletes its stored credential and stops making Gorelo calls. Disconnecting does not revoke the upstream API key; revoke it separately under Settings → Integrations → API. Connector subscription changes are separate from credential disconnection.

Troubleshooting

Symptom	Likely cause	What to do
The drawer shows Needs Attention after saving	Wrong region, a mis-pasted key, or the key lacks Clients (read)	Re-check the region and generate a replacement key with Clients (read), then save and choose Re-test
One tool returns a 403 while others succeed	The key lacks the permission scope that operation needs	Generate a replacement key under Settings → Integrations → API with the required scope, update StackJack, and revoke the old key after validation
Tools worked, then started failing	The key was regenerated or revoked in Gorelo	Paste the current key in Connectors → Gorelo → Configure and save
A file your AI uploaded isn't on the ticket	Uploading stores the file and returns a link; it doesn't attach it on its own	Ask your AI to post a comment on the ticket carrying that file — the upload and the comment are two steps
A long comment comes back cut off	Comment lists return shortened bodies	Ask your AI to fetch that single comment; the single-comment read always returns the full text
A list seems to stop early, or repeats the same page	The list was paged and the follow-up page wasn't requested	Gorelo returns results a page at a time. Ask your AI to continue to the next page; it carries a cursor from the previous response
Write tools missing from your AI's tool list	Connector is on the Free tier, or the tools aren't selected for your client	Upgrade the Gorelo connector plan and check your tool selections on the MCP Setup page
A calls-per-minute burst slows down	StackJack is pacing requests towards Gorelo's limit	Expected. Narrow the request if it does not finish.

Gorelo tools

gorelo_ · 46 tools · Free 25 · Pro 21

Contacts

Tool	What it does
`gorelo_create_contact` Pro · Write	Create a contact under a client.
`gorelo_delete_contact` Pro · Destructive	Delete a contact (person) by its numeric id.
`gorelo_get_contact` Free · Read-only	Get a single contact by its numeric id (from gorelo_list_contacts).
`gorelo_list_contacts` Free · Read-only	List contacts (people) in the Gorelo CRM.
`gorelo_update_contact` Pro · Write	Update an existing contact.

Clients

Tool	What it does
`gorelo_create_client` Pro · Write	Create a client (company).
`gorelo_delete_client` Pro · Destructive	Delete a client (company) by its numeric id.
`gorelo_get_client` Free · Read-only	Get a single client (company) by its numeric id (from gorelo_list_clients).
`gorelo_list_client_locations` Free · Read-only	List the locations (sites) for one client.
`gorelo_list_clients` Free · Read-only	List all clients (companies) in the Gorelo CRM.
`gorelo_update_client` Pro · Write	Update an existing client (company).

Assets

Tool	What it does
`gorelo_delete_agent_asset` Pro · Destructive	Delete an RMM agent device by its UUID id (from gorelo_list_agents).
`gorelo_delete_custom_asset` Pro · Destructive	Delete a custom (non-agent) asset by its UUID id (from gorelo_list_custom_assets).
`gorelo_get_agent` Free · Read-only	Get a single RMM agent device by its UUID id (from gorelo_list_agents).
`gorelo_list_agents` Free · Read-only	List all RMM agent devices.
`gorelo_list_custom_assets` Free · Read-only	List custom (non-agent) assets — the equipment tracked in Gorelo without an RMM agent on it, such as switches, printers, firewalls and licences.

Billing

Tool	What it does
`gorelo_get_invoice_pdf` Free · Read-only	Download the rendered PDF for an invoice by its UUID id.
`gorelo_list_billing_roles` Free · Read-only	List the billing roles configured for your organization.
`gorelo_list_contracts` Free · Read-only	List billing contracts, each with its service lines inline.
`gorelo_list_work_types` Free · Read-only	List the work types configured for your organization.

Time Entries

Tool	What it does
`gorelo_create_time_entry` Pro · Write	Log time against a ticket.
`gorelo_delete_time_entry` Pro · Destructive	Delete a time entry by its numeric id.
`gorelo_get_time_entry` Free · Read-only	Get a single time entry by its numeric id (from gorelo_list_time_entries).
`gorelo_list_time_entries` Free · Read-only	List logged time across every ticket and task.
`gorelo_update_time_entry` Pro · Write	Partially update a time entry by its numeric id.

Alerts

Tool	What it does
`gorelo_create_alert` Pro · Write	Raise an alert for a client.

Tickets

Tool	What it does
`gorelo_create_ticket` Pro · Write	Create a PSA ticket.
`gorelo_delete_ticket` Pro · Destructive	Delete a ticket by its UUID.
`gorelo_get_ticket` Free · Read-only	Get a single ticket by its UUID (from gorelo_list_tickets, or the ticketId gorelo_create_ticket returns).
`gorelo_list_ticket_statuses` Free · Read-only	List the configured ticket statuses (id, name, baseStatusId, color, sortOrder, description).
`gorelo_list_ticket_tags` Free · Read-only	List the configured ticket tags (id, name, description, isAiTag).
`gorelo_list_ticket_types` Free · Read-only	List the configured ticket types (id, name, description, isAiType).
`gorelo_list_tickets` Free · Read-only	List tickets.
`gorelo_update_ticket` Pro · Write	Partially update a ticket by its UUID.

Ticket Conversations

Tool	What it does
`gorelo_add_ticket_comment` Pro · Write	Add a comment to a ticket.
`gorelo_create_ticket_approval` Pro · Write	Create an approval on a ticket.
`gorelo_create_ticket_side_conversation` Pro · Write	Create a side conversation on a ticket - a thread aimed at someone outside the ticket's main correspondence, such as a vendor.
`gorelo_delete_ticket_comment` Pro · Destructive	Delete a comment from a ticket.
`gorelo_get_ticket_approval` Free · Read-only	Get a single approval on a ticket, with its approvers.
`gorelo_get_ticket_comment` Free · Read-only	Get a single comment on a ticket.
`gorelo_list_ticket_comments` Free · Read-only	List the comments on a ticket.
`gorelo_list_ticket_conversations` Free · Read-only	List the conversations on a ticket.

Attachments

Tool	What it does
`gorelo_upload_ticket_attachment` Pro · Write	Upload a single file to a ticket.

Uptime

Tool	What it does
`gorelo_delete_uptime_check` Pro · Destructive	Delete an uptime check by its UUID.

Organization

Tool	What it does
`gorelo_list_organization_groups` Free · Read-only	List the groups (teams) in your Gorelo organization.
`gorelo_list_organization_users` Free · Read-only	List the users in your Gorelo organization (your MSP's technicians/staff, not client contacts).

Still need help? Ask the team