Skip to main content
Connector guides

Connect Atera

Atera is an all-in-one RMM (remote monitoring and management) and PSA (professional services automation) platform for MSPs and internal IT teams. It brings device monitoring, ticketing, customers and…

Written By Christopher Scaminaci

Last updated 6 days ago

Atera is an all-in-one RMM (remote monitoring and management) and PSA (professional services automation) platform for MSPs and internal IT teams. It brings device monitoring, ticketing, customers and contacts, contracts, billing and rates, and custom fields together in one cloud console.

Connecting Atera to StackJack gives your AI assistant a broad family of atera_ MCP tools — MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. Depending on the tools you enable, your AI can:

  • Inventory RMM agents and the four monitored-device families (generic, HTTP, SNMP, TCP)
  • Triage alerts and search the knowledge base
  • Manage the PSA side — customers, end-user contacts, contracts, and tickets (with their comments and work-hours)
  • Review billing invoices and the rates catalog (products and expenses)
  • Read and set the account's custom-field values across agents, tickets, customers, contacts, contracts, SLAs, and devices
  • Act — create and update operational records, with destructive actions separately identified for consent-aware clients

How StackJack authenticates to Atera

Atera uses a named API token sent in the X-API-KEY header on every request. An Atera Administrator creates it under Admin → Data management → API. Atera lets you create multiple tokens, set an expiration up to one year away, restrict source IPs, and choose either Full access or Custom access by API domain and action (Read, Write, and Delete). Treat the token like a password even when it is narrowly scoped.

There is no OAuth, login redirect, or refresh flow. StackJack calls authenticate as the configured token rather than as the currently signed-in technician, so Atera does not provide per-call interactive-user attribution.

Atera is a single global cloud (https://app.atera.com), so there is no region to choose — the connector form asks only for the API key.

Before you begin

  • In StackJack: you need a role that can manage connectors (tenant Owner, a co-owner, or an Administrator).
  • In Atera: you need an Administrator account to manage tokens under Admin → Data management → API.
  • Decide which StackJack tools you plan to enable. That determines which Atera API domains and Read, Write, or Delete actions the token needs.
  • Review Atera's current Using the Atera API instructions before creating the token.

Step 1 — Create a least-privilege Atera token

  1. Sign in to Atera with an Administrator account.
  2. Go to Admin → Data management → API, then select New token.
  3. Give the token a recognizable name and choose an expiration date no more than one year away.
  4. Allow all source IPs, or configure the IP allowlist your environment requires. StackJack does not publish its outbound addresses: open a support ticket to get the current addresses for your region before you enable the restriction, and ask again after a region move, because they change.
  5. Prefer Custom access. Grant the API domains that match your selected StackJack tools and only the required Read, Write, and Delete actions. Choose Full access only when you intentionally need the entire connector surface.
  6. Create the token and copy it immediately. Atera shows the token value only once.

Step 2 — Add the credential in StackJack

  1. In the StackJack portal, open Connectors.
  2. Select the Atera tile to open its details. Choose How To Connect to review the inline setup guide, or Configure to reveal the credential form in the drawer.
  3. Paste the Atera token into API Key.
  4. Click Save.

What happens when you save

  • The token 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 Atera, a Free-tier subscription for the connector is created automatically so its Free tools work right away.
  • StackJack immediately live-validates the token with a one-row customers request. Validation never blocks the save.
  • After saving, the form collapses and the connector drawer stays open. It shows Connected / Valid on success, or Needs Attention with Re-test and recovery guidance if validation failed.

Plans and available tools

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

Current pricing and quotas are shown in the portal's Billing page and at checkout.

Safety note. Least privilege has two layers: the Atera token's API-domain/action permissions and the tools you enable in StackJack on the MCP Setup and Permissions pages. A tool labeled destructive can permanently change or remove upstream data; review its current schema and destructive label in the generated reference before enabling it.

How Atera paginates

List tools use a one-based page number and page size. Most Atera list endpoints in the checked-in API contract allow up to 500 items per page. Ticket-family endpoints allow 50. StackJack also uses a 50-item safety cap for the few list endpoints whose contract does not publish a maximum. A large read therefore may require several calls, and callers must continue paging until the response indicates the end.

Rate limits

Atera's current public setup guide and API FAQ do not state a numeric upstream request ceiling. StackJack conservatively paces Atera calls at 600 requests per minute per tenant and reacts to HTTP 429 responses. Other callers using the same token and Atera-side policy are outside that local budget, so a rate-limit response can still occur; honor the retry delay rather than immediately repeating a large batch.

Rotating or replacing the credential

Atera supports multiple named tokens, so you can rotate without intentionally creating a gap: create a replacement under Admin → Data management → API, copy it once, update Connectors → Atera → Configure in StackJack, save, and confirm Valid. Only then revoke the old Atera token. Repeat this before its configured expiration, and rotate immediately if it may have been exposed.

Disconnecting Atera

Using Disconnect in the Atera connector drawer removes StackJack's stored credential and stops future connector calls. It does not revoke the token in Atera. Revoke or delete that token separately under Admin → Data management → API when it is no longer used anywhere else. Disconnecting credentials and changing a paid connector subscription are separate actions; review the drawer's subscription choice before confirming.

Troubleshooting

SymptomLikely causeWhat to do
Needs Attention immediately after savingThe token was mis-pasted, expired, revoked, or blocked by its source-IP policyReview it under Admin → Data management → API, update Connectors → Atera → Configure, then use Re-test
A specific tool returns HTTP 403 while others workThe token's Custom access does not grant that API domain/action, or its IP restriction blocks the requestGrant the matching Read, Write, or Delete action and verify the IP allowlist, then use Re-test
Tools worked, then all started returning HTTP 401The stored token expired or was revokedCreate a replacement token, update the connector, confirm Valid, then retire the old token if it still exists
Write or delete tools missing from your AI's tool listConnector is on the Free tier, or the tools aren't selected for your clientUpgrade the Atera connector plan and check your tool selections on the MCP Setup page
A ticket list needs more pages than another listTicket-family endpoints cap pages at 50; most other list endpoints allow up to 500Continue using the returned paging information until the read is complete
HTTP 429Atera's upstream allowance was consumed by this or another callerHonor the retry delay and reduce concurrency or batch size; StackJack's local 600/minute pacing cannot account for other callers

Atera tools

atera_ · 115 tools · Free 67 · Pro 48

Agents

ToolWhat it does
atera_delete_agent
Pro · Destructive
Permanently delete (uninstall) an RMM agent by its numeric AgentID (from atera_list_agents).
atera_get_agent
Free · Read-only
Get the full detail of a single RMM agent by its numeric AgentID (from atera_list_agents or atera_list_agents_by_customer).
atera_get_agents_by_machine
Free · Read-only
Get the RMM agent(s) installed on a machine identified by its machine name (hostname).
atera_list_agent_available_patches
Free · Read-only
List the patches AVAILABLE (pending/not-yet-installed) for the machine behind an RMM agent, keyed by the agent's deviceGuid (the agent's DeviceGuid string, a GUID — from the DeviceGuid field on atera_get_agent / atera_list_agents, NOT the numeric AgentID).
atera_list_agent_installed_patches
Free · Read-only
List the patches already INSTALLED on the machine behind an RMM agent, keyed by the agent's deviceGuid (the agent's DeviceGuid string, a GUID — from the DeviceGuid field on atera_get_agent / atera_list_agents, NOT the numeric AgentID).
atera_list_agents
Free · Read-only
List all RMM agents (monitoring software installed on managed machines) across every customer.
atera_list_agents_by_customer
Free · Read-only
List the RMM agents belonging to a single customer, identified by its numeric CustomerID (from atera_list_customers).

Devices

ToolWhat it does
atera_create_generic_device
Pro · Write
Create a generic monitored device (a device pinged/monitored without a family-specific protocol).
atera_create_http_device
Pro · Write
Create an HTTP monitored device (website/endpoint uptime + content check).
atera_create_snmp_device_v1v2
Pro · Write
Create an SNMP-monitored device using SNMP v1 or v2c.
atera_create_snmp_device_v3
Pro · Write
Create an SNMP-monitored device using SNMP v3 (user-based security model).
atera_create_tcp_device
Pro · Write
Create a TCP monitored device (port-reachability check on a host).
atera_delete_generic_device
Pro · Destructive
Permanently delete a generic monitored device by its numeric DeviceID (from atera_list_generic_devices).
atera_delete_http_device
Pro · Destructive
Permanently delete an HTTP monitored device by its numeric DeviceID (from atera_list_http_devices).
atera_delete_snmp_device
Pro · Destructive
Permanently delete an SNMP monitored device by its numeric DeviceID (from atera_list_snmp_devices).
atera_delete_tcp_device
Pro · Destructive
Permanently delete a TCP monitored device by its numeric DeviceID (from atera_list_tcp_devices).
atera_get_generic_device
Free · Read-only
Get a single generic monitored device by its numeric DeviceID (from atera_list_generic_devices).
atera_get_http_device
Free · Read-only
Get a single HTTP monitored device by its numeric DeviceID (from atera_list_http_devices).
atera_get_snmp_device
Free · Read-only
Get a single SNMP monitored device by its numeric DeviceID (from atera_list_snmp_devices).
atera_get_tcp_device
Free · Read-only
Get a single TCP monitored device by its numeric DeviceID (from atera_list_tcp_devices).
atera_list_generic_devices
Free · Read-only
List all generic monitored devices.
atera_list_http_devices
Free · Read-only
List all HTTP monitored devices.
atera_list_snmp_devices
Free · Read-only
List all SNMP monitored devices (both v1/v2c and v3).
atera_list_tcp_devices
Free · Read-only
List all TCP monitored devices.

Alerts

ToolWhat it does
atera_create_alert
Pro · Write
Raise a new alert.
atera_delete_alert
Pro · Destructive
Permanently delete (clear) an alert by its numeric AlertID (from atera_list_alerts).
atera_get_alert
Free · Read-only
Get the full detail of a single alert by its numeric AlertID (from atera_list_alerts).
atera_list_alerts
Free · Read-only
List monitoring alerts across all agents and devices.
atera_update_alert
Pro · Write
Update an alert by its numeric AlertID (from atera_list_alerts).

Knowledge Base

ToolWhat it does
atera_list_knowledgebase_articles
Free · Read-only
List the knowledge-base articles configured in the Atera account.

Account

ToolWhat it does
atera_get_account
Free · Read-only
Get the Atera account/tenant profile — the top-level account info for the API key in use (account name, plan/edition, and account-level identifiers).

Departments

ToolWhat it does
atera_create_department
Pro · Write
Create a help-desk department.
atera_delete_department
Pro · Destructive
Permanently delete a help-desk department by its numeric department id (from atera_list_departments).
atera_get_department
Free · Read-only
Get a single help-desk department by its numeric department id (from atera_list_departments).
atera_list_departments
Free · Read-only
List the help-desk departments defined in the Atera account.
atera_update_department
Pro · Write
Update a help-desk department by its numeric department id (from atera_list_departments).

Customers

ToolWhat it does
atera_create_customer
Pro · Write
Create a customer (company/organization).
atera_create_customer_attachment
Pro · Write
Attach a file to a customer.
atera_create_customer_folder
Pro · Write
Create a customer folder (a grouping/organizational folder used to organize customers).
atera_delete_customer
Pro · Destructive
Permanently delete a customer by CustomerID (from atera_list_customers).
atera_get_customer
Free · Read-only
Get a single customer by CustomerID (from atera_list_customers).
atera_list_customers
Free · Read-only
List the customers (companies/organizations) in your Atera account.
atera_update_customer
Pro · Write
Update a customer by CustomerID (from atera_list_customers).

Contacts

ToolWhat it does
atera_create_contact
Pro · Write
Create an end-user contact under a customer.
atera_delete_contact
Pro · Destructive
Permanently delete an end-user contact by its contact id (EndUserID, from atera_list_contacts).
atera_get_contact
Free · Read-only
Get a single end-user contact by its contact id (EndUserID, from atera_list_contacts).
atera_list_contacts
Free · Read-only
List the end-user contacts across your customers.
atera_update_contact
Pro · Write
Update an end-user contact by its contact id (EndUserID, from atera_list_contacts).

Contracts

ToolWhat it does
atera_create_contract
Pro · Write
Create a contract (billing agreement) for a customer.
atera_get_contract
Free · Read-only
Get a single contract by ContractID (from atera_list_contracts or atera_list_contracts_by_customer).
atera_list_contracts
Free · Read-only
List all contracts (billing agreements) in your Atera account.
atera_list_contracts_by_customer
Free · Read-only
List the contracts for a single customer, identified by CustomerID (from atera_list_customers).
atera_update_contract
Pro · Write
Update a contract by ContractID (from atera_list_contracts).

Tickets

ToolWhat it does
atera_add_ticket_comment
Pro · Write
Add a comment to a ticket by TicketID (from atera_list_tickets).
atera_add_ticket_relation
Pro · Write
Link a ticket to another ticket, by TicketID (from atera_list_tickets) — vendor endpoint POST /tickets/{ticketId}/relations.
atera_create_ticket
Pro · Write
Create a help-desk ticket.
atera_delete_ticket
Pro · Destructive
Permanently delete a ticket by TicketID (from atera_list_tickets).
atera_delete_ticket_relation
Pro · Destructive
Delete a relation from a ticket by TicketID + the relation's RelationType, vendor endpoint DELETE /tickets/{ticketId}/relations/{relationType}.
atera_get_ticket
Free · Read-only
Get a single ticket by TicketID (from atera_list_tickets).
atera_get_ticket_billable_duration
Free · Read-only
Get the total billable duration logged against a ticket by TicketID (from atera_list_tickets).
atera_get_ticket_billable_workhours_site_duration
Free · Read-only
Get the billable work-hours site-duration for a BATCH of tickets in one call (vendor endpoint POST /tickets/billableworkhourssiteduration — the site-time variant of the batch billable-duration endpoint).
atera_get_ticket_comments
Free · Read-only
Get the comment/conversation thread for a ticket by TicketID (from atera_list_tickets).
atera_get_ticket_nonbillable_duration
Free · Read-only
Get the total non-billable duration logged against a ticket by TicketID (from atera_list_tickets).
atera_get_ticket_workhours
Free · Read-only
Get the aggregate work-hours summary for a ticket by TicketID (from atera_list_tickets) — the combined billable + non-billable time.
atera_list_ticket_attachments
Free · Read-only
List the attachment METADATA (filenames, ids, sizes, upload timestamps) for a ticket by TicketID (from atera_list_tickets).
atera_list_ticket_workhours_records
Free · Read-only
List the individual work-hours (time-entry) records for a ticket by TicketID (from atera_list_tickets).
atera_list_tickets
Free · Read-only
List help-desk tickets.
atera_list_tickets_billable_duration
Free · Read-only
Get the billable duration for a BATCH of tickets in one call (vendor endpoint POST /tickets/billableduration).
atera_list_tickets_last_modified
Free · Read-only
List tickets by LAST-ACTIVITY date (most recent activity on/after a date) — distinct from atera_list_tickets_status_modified, which keys off the last STATUS CHANGE.
atera_list_tickets_status_modified
Free · Read-only
List tickets whose status changed (e.g. resolved/closed tickets by status-change date) — useful for reporting on recently closed work.
atera_update_ticket
Pro · Write
Update a ticket by TicketID (from atera_list_tickets).

Billing

ToolWhat it does
atera_get_invoice
Free · Read-only
Get a single invoice by its invoice NUMBER (from atera_list_invoices) — this endpoint is keyed by the human-readable invoice number, not a numeric id.
atera_list_invoices
Free · Read-only
List billing invoices.

Rates

ToolWhat it does
atera_create_expense
Pro · Write
Create a billable expense in the rates catalog.
atera_create_product
Pro · Write
Create a billable product in the rates catalog.
atera_delete_expense
Pro · Destructive
Permanently delete a billable expense by ExpenseID (from atera_list_expenses).
atera_delete_product
Pro · Destructive
Permanently delete a billable product by ProductID (from atera_list_products).
atera_get_expense
Free · Read-only
Get a single billable expense by ExpenseID (from atera_list_expenses).
atera_get_product
Free · Read-only
Get a single billable product by ProductID (from atera_list_products).
atera_list_expenses
Free · Read-only
List the billable expenses in your rates catalog.
atera_list_products
Free · Read-only
List the billable products in your rates catalog.
atera_update_expense
Pro · Write
Update a billable expense by ExpenseID (from atera_list_expenses).
atera_update_product
Pro · Write
Update a billable product by ProductID (from atera_list_products).

Custom Values

ToolWhat it does
atera_get_agent_custom_field
Free · Read-only
Get the value of a named custom field on an agent (installed device).
atera_get_contact_custom_field
Free · Read-only
Get the value of a named custom field on a contact (end user).
atera_get_contract_custom_field
Free · Read-only
Get the value of a named custom field on a contract.
atera_get_custom_value
Free · Read-only
Fetch a single custom-value record by its internal row id — a GUID string (the CustomFieldValueID Atera assigns each stored value), NOT a number.
atera_get_customer_custom_field
Free · Read-only
Get the value of a named custom field on a customer (managed organization).
atera_get_generic_device_custom_field
Free · Read-only
Get the value of a named custom field on a generic monitored device.
atera_get_http_device_custom_field
Free · Read-only
Get the value of a named custom field on an HTTP monitored device.
atera_get_sla_custom_field
Free · Read-only
Get the value of a named custom field on an SLA.
atera_get_snmp_device_custom_field
Free · Read-only
Get the value of a named custom field on an SNMP monitored device.
atera_get_tcp_device_custom_field
Free · Read-only
Get the value of a named custom field on a TCP monitored device.
atera_get_ticket_custom_field
Free · Read-only
Get the value of a named custom field on a ticket.
atera_list_agent_custom_fields
Free · Read-only
List ALL custom-field values set on an agent, by agentId (from atera_list_agents).
atera_list_contact_custom_fields
Free · Read-only
List ALL custom-field values set on a contact, by contactId (from atera_list_contacts).
atera_list_contract_custom_fields
Free · Read-only
List ALL custom-field values set on a contract, by contractId (from atera_list_contracts).
atera_list_custom_fields
Free · Read-only
List every custom field defined on the account — the catalog of user-defined fields you can read or set on agents, tickets, customers, contracts, contacts, SLAs and devices.
atera_list_customer_custom_fields
Free · Read-only
List ALL custom-field values set on a customer, by customerId (from atera_list_customers).
atera_list_generic_device_custom_fields
Free · Read-only
List ALL custom-field values set on a generic monitored device, by genericDeviceId (from atera_list_generic_devices).
atera_list_http_device_custom_fields
Free · Read-only
List ALL custom-field values set on an HTTP monitored device, by httpDeviceId (from atera_list_http_devices).
atera_list_sla_custom_fields
Free · Read-only
List ALL custom-field values set on an SLA, by slaId.
atera_list_snmp_device_custom_fields
Free · Read-only
List ALL custom-field values set on an SNMP monitored device, by snmpDeviceId (from atera_list_snmp_devices).
atera_list_tcp_device_custom_fields
Free · Read-only
List ALL custom-field values set on a TCP monitored device, by tcpDeviceId (from atera_list_tcp_devices).
atera_list_ticket_custom_fields
Free · Read-only
List ALL custom-field values set on a ticket, by ticketId (from atera_list_tickets).
atera_set_agent_custom_field
Pro · Write
Set the value of a named custom field on an agent.
atera_set_contact_custom_field
Pro · Write
Set the value of a named custom field on a contact (end user).
atera_set_contract_custom_field
Pro · Write
Set the value of a named custom field on a contract.
atera_set_customer_custom_field
Pro · Write
Set the value of a named custom field on a customer (managed organization).
atera_set_generic_device_custom_field
Pro · Write
Set the value of a named custom field on a generic monitored device.
atera_set_http_device_custom_field
Pro · Write
Set the value of a named custom field on an HTTP monitored device.
atera_set_sla_custom_field
Pro · Write
Set the value of a named custom field on an SLA.
atera_set_snmp_device_custom_field
Pro · Write
Set the value of a named custom field on an SNMP monitored device.
atera_set_tcp_device_custom_field
Pro · Write
Set the value of a named custom field on a TCP monitored device.
atera_set_ticket_custom_field
Pro · Write
Set the value of a named custom field on a ticket.