Gorelo MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.6.4Updated Nov 7, 2026

Read tickets, devices, alerts and invoices; create tickets, add comments, log time in Gorelo.

The publisher's own server: Ably MCP by usefulapi

Overview

AI-generated overview

Hosted MCP server for Gorelo MSP software: read clients, tickets, devices, alerts and invoices, and create tickets, comments and time entries.

What you can do
  • List and read clients, locations, contacts, technicians and groups
  • List and read service tickets, their comments, statuses, types and priorities
  • List managed devices with hardware and pending Windows updates, plus custom assets
  • List alerts and read alert details
  • List projects, project tasks, time entries, invoices and billing contracts
  • Create and update tickets, add public or private comments, change alert status and log time
When to use it
Useful for managed service providers and IT teams that work in Gorelo and want an assistant to answer questions about open tickets, offline devices, overdue invoices or logged time, and to file tickets, reply to clients or log work without switching apps.
Requirements
Remote streamable HTTP endpoint; no local install. Sign-in uses OAuth, and on first connect you supply a Gorelo API key and your data region (Gorelo settings, integrations). No API key or Authorization header goes in the client config. A usefulapi.io plan governs usage: free tier is 50 tool calls per month; paid plans are billed through Stripe.
Before you install
Write tools change real Gorelo data: creating or updating tickets notifies and logs as in the app, changing a ticket's client clears its contact and assets, and public comments may be emailed to the client. Do not retry add-comment or log-time calls after unclear errors, as that can duplicate them. Your Gorelo API key is stored by the third-party host. Paid plans cost money and cancellation gives no refund for the current period.

Installation

In SourceWeft

  1. Open Gorelo MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fgorelo/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "gorelo-by-usefulapi": {
      "type": "http",
      "url": "https://gorelo.usefulapi.io/mcp"
    }
  }
}

README

Gorelo MCP by usefulapi

Use your Gorelo account from Claude, Cursor, or any MCP client. Read clients, tickets, managed devices, alerts, projects and invoices, and create tickets, add comments or log time. Hosted, no local install: connect with your own credentials.

Live endpoint: https://gorelo.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://gorelo.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http gorelo https://gorelo.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "gorelo": {      "url": "https://gorelo.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Gorelo credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/gorelo/

On first connect you provide a Gorelo API key and your data region (Gorelo → Settings → Integrations → Generate New Key). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
gorelo_list_clientsreadList clients
gorelo_get_clientreadGet a client
gorelo_list_client_locationsreadList client locations
gorelo_list_contactsreadList contacts
gorelo_get_contactreadGet a contact
gorelo_list_ticketsreadList tickets
gorelo_get_ticketreadGet a ticket
gorelo_list_ticket_commentsreadList ticket comments
gorelo_list_ticket_statusesreadList ticket statuses
gorelo_list_ticket_typesreadList ticket types
gorelo_list_ticket_prioritiesreadList ticket priorities
gorelo_list_agent_assetsreadList managed devices
gorelo_get_agent_assetreadGet a managed device
gorelo_get_agent_hardwarereadGet device hardware
gorelo_list_agent_pending_updatesreadList device pending updates
gorelo_list_custom_assetsreadList custom assets
gorelo_list_alertsreadList alerts
gorelo_get_alertreadGet an alert
gorelo_list_projectsreadList projects
gorelo_list_project_tasksreadList project tasks
gorelo_list_time_entriesreadList time entries
gorelo_list_invoicesreadList invoices
gorelo_get_invoicereadGet an invoice
gorelo_list_contractsreadList contracts
gorelo_list_usersreadList technicians
gorelo_list_groupsreadList technician groups
gorelo_create_ticketwriteCreate a ticket
gorelo_update_ticketwriteUpdate a ticket
gorelo_add_ticket_commentwriteAdd a ticket comment
gorelo_update_alert_statuswriteUpdate an alert status
gorelo_log_time_entrywriteLog time on a ticket
gorelo_usage_statusmetaUsage status (free-tier meter)
gorelo_request_featuremetaRequest a missing feature
gorelo_upgrademetaUpgrade to Pro or Pro+
gorelo_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with gorelo_upgrade (it returns a Stripe Checkout link). Cancel any time with gorelo_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running gorelo_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/gorelo/README.md at commit 4046075

Tools

31

gorelo_list_clients

List clients

List the MSP's clients (customers). Good first call to find a client id. API: GET /v1/clients.

Parametersquerycursorgroup_idspage_sizestatus_idscreated_sinceupdated_since

gorelo_get_client

Get a client

Get one client by id with its details. API: GET /v1/clients/{clientId}.

Parametersclient_idrequired

gorelo_list_client_locations

List client locations

List the locations (sites) of one client. API: GET /v1/clients/{clientId}/locations.

Parametersclient_idrequired

gorelo_list_contacts

List contacts

List client contacts (end users). API: GET /v1/contacts.

Parametersquerycursorpage_sizeclient_idsstatus_idslocation_idsupdated_since

gorelo_get_contact

Get a contact

Get one contact by id. API: GET /v1/contacts/{contactId}.

Parameterscontact_idrequired

gorelo_list_tickets

List tickets

List service tickets, newest activity first, with status, priority, client, assignees and SLA. Use the list_ticket_statuses/types/priorities tools to learn the ids for filters. API: GET /v1/tickets.

Parametersquerycursorsort_bytag_idstype_idsgroup_idspage_sizeclient_idsdevice_idssort_orderstatus_idscontact_ids+6 more

gorelo_get_ticket

Get a ticket

Get one ticket by id (uuid). API: GET /v1/tickets/{ticketId}.

Parametersticket_idrequired

gorelo_list_ticket_comments

List ticket comments

List the comments (public replies, private notes) on a ticket. API: GET /v1/tickets/{ticketId}/comments.

Parameterscursorpage_sizeticket_idrequiredsort_orderconversation_idconversation_type

gorelo_list_ticket_statuses

List ticket statuses

List the ticket statuses (id and name) used to filter or update tickets. API: GET /v1/tickets/statuses.

Takes no parameters.

gorelo_list_ticket_types

List ticket types

List the ticket types. API: GET /v1/tickets/types.

Takes no parameters.

gorelo_list_ticket_priorities

List ticket priorities

List the ticket priorities. API: GET /v1/tickets/priorities.

Takes no parameters.

gorelo_list_agent_assets

List managed devices

List agent (RMM managed device) assets with status, OS and client. API: GET /v1/assets/agents.

Parametersquerycursorpage_sizeclient_idsstatus_idsupdated_since

gorelo_get_agent_asset

Get a managed device

Get one managed device by id (guid). API: GET /v1/assets/agents/{agentAssetId}.

Parametersagent_asset_idrequired

gorelo_get_agent_hardware

Get device hardware

Get a managed device's processors, memory and disks. API: GET /v1/assets/agents/{agentAssetId}/hardware.

Parametersagent_asset_idrequired

gorelo_list_agent_pending_updates

List device pending updates

List the Windows updates pending on a managed device, from its last scan (no new scan starts). API: GET /v1/assets/agents/{agentAssetId}/patches/available.

Parametersagent_asset_idrequired

gorelo_list_custom_assets

List custom assets

List custom (non-agent) assets such as printers, switches and licences. API: GET /v1/assets/custom.

Parametersquerycursorpage_sizeclient_idsupdated_since

gorelo_list_alerts

List alerts

List alerts (uptime, script, external, ...) newest first. API: GET /v1/alerts.

Parameterscursortype_idspage_sizeclient_idssort_orderstatus_idscreated_sincecreated_beforeagent_asset_ids

gorelo_get_alert

Get an alert

Get one alert by id (guid). API: GET /v1/alerts/{alertId}.

Parametersalert_idrequired

gorelo_list_projects

List projects

List projects with status, client and lead. API: GET /v1/projects.

Parametersquerycursorsort_bypage_sizeclient_idssort_orderstatus_idsupdated_since

gorelo_list_project_tasks

List project tasks

List the tasks of one project. API: GET /v1/projects/{projectId}/tasks.

Parameterscursorsort_bypage_sizeproject_idrequiredsort_orderstatus_idsassignee_idsincomplete_only

gorelo_list_time_entries

List time entries

List logged time across tickets and tasks. API: GET /v1/time-entries.

Parameterscursortask_idsuser_idspage_sizeclient_idsticket_idsinvoice_idsstarted_sincestarted_before

gorelo_list_invoices

List invoices

List invoices with status, totals and client. API: GET /v1/invoices.

Parametersquerycursorsort_bypage_sizeclient_idssort_orderstatus_idscontract_idsdue_date_beforeinvoice_date_sinceinvoice_date_before

gorelo_get_invoice

Get an invoice

Get one invoice with its line items and attachments. API: GET /v1/invoices/{invoiceId}.

Parametersinvoice_idrequired

gorelo_list_contracts

List contracts

List billing contracts with their service lines. API: GET /v1/contracts.

Parametersquerycursorpage_sizeclient_idsstatus_ids

gorelo_list_users

List technicians

List users (technicians) with role and status; use their ids as assignee ids. API: GET /v1/organization/users.

Parametersquerycursorgroup_idspage_sizestatus_ids

gorelo_list_groups

List technician groups

List technician groups (ids are needed to create a ticket). API: GET /v1/organization/groups.

Takes no parameters.

gorelo_create_ticket

Create a ticket

WRITE: create a service ticket. Needs status_id, group_id and type_id (use gorelo_list_ticket_statuses, gorelo_list_groups, gorelo_list_ticket_types). Set send_created_email true only if the contact must get a 'ticket created' email. API: POST /v1/tickets.

Parameterstitlerequiredtag_idstype_idrequiredgroup_idrequiredclient_idsource_idstatus_idrequiredcontact_iddescriptionlocation_idpriority_idagent_asset_ids+2 more

gorelo_update_ticket

Update a ticket

WRITE: change fields of a ticket (status, priority, assignee, title, tags). Only the fields you send change. Each change notifies and logs as in the app. Changing the client clears the ticket's contact and assets. API: PATCH /v1/tickets/{ticketId}.

Parameterstitletag_idstype_idclient_idstatus_idticket_idrequiredcontact_idpriority_idlead_assignee_id

gorelo_add_ticket_comment

Add a ticket comment

WRITE: add a comment to a ticket's main thread. A 'public' comment is a reply the client sees and may be emailed to them; a 'private' comment is an internal note. Do not retry after an unclear error: that can post twice. API: POST /v1/tickets/{ticketId}/comments.

Parametersbodyrequiredticket_idrequiredvisibilityrequired

gorelo_update_alert_status

Update an alert status

WRITE: dismiss an alert, restore it to New, or link it to an open ticket (status 'ticketed' needs ticket_id). The change applies to the alert's whole stack, as in the app. API: PATCH /v1/alerts/{alertId}.

Parametersstatusrequiredalert_idrequiredticket_id

gorelo_log_time_entry

Log time on a ticket

WRITE: log work time against a ticket (or a project task). Give any two of started_on, ended_on and actual_hours (the API derives the third). Billing role, work type and billable status default from the ticket. Do not retry after an unclear error: that can log twice. API: POST /v1/time-entries.

Parameterscommenttask_iduser_idended_onticket_idstarted_onactual_hoursbillable_status_id

Version history

9
  1. v1.6.4LatestNov 7, 2026
  2. v1.5.3Nov 5, 2026
  3. v1.5.2Nov 5, 2026
  4. v1.5.1Nov 4, 2026
  5. v1.5.0Nov 3, 2026
  6. v1.4.1Nov 3, 2026
  7. v1.3.0Nov 1, 2026
  8. v1.1.0Oct 31, 2026
  9. v1.0.0Oct 31, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations