servosity/msp-skills/atera

Atera - Claude Code Skill

Prerequisites: Install the CLI

This skill drives the atera-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. macOS / Linux:

``bash bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/atera/install.sh) ``

1. Windows (PowerShell):

``powershell iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/atera/install.ps1 | iex ``

1. Verify: atera-cli --version
2. Ensure ~/.local/bin (macOS / Linux) or %LOCALAPPDATA%\Programs\msp-skills (Windows) is on $PATH.

The installer downloads the atera-cli and atera-mcp binaries into ~/.local/bin (macOS / Linux) or %LOCALAPPDATA%\Programs\msp-skills (Windows). It does not register the skill with your agent and writes no MCP client config - see mcp-install.md for that wire-up.

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

A single static API key unlocks full CRUD across agents, tickets, customers, contracts, alerts, devices, rates, and custom fields. The difference is the local store: sync once, then run offline cross-entity queries like agents stale, tickets sla, customers book, and since that every thin API wrapper leaves on the table.

When to Use This CLI

Reach for this CLI for any Atera RMM/PSA task an agent runs from the terminal: pulling or mutating agents, tickets, customers, contracts, alerts, devices, rates, and custom fields. It is the right choice when the question spans more than one entity or a time window - dark-agent sweeps, SLA-breach triage, technician load, book-of-business reviews, and change summaries - because those run against the local synced store instead of N paginated API calls.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Fleet health that compounds

• `agents stale` - Surface agents that have gone quiet - offline or not seen in N days - before the client calls to complain.

_Reach for this when an agent asks which machines stopped reporting - it is a time-window query the live API cannot express._

``bash atera-cli agents stale --days 30 --agent ``

• `agents inventory` - Roll up OS and OS-type counts across the whole estate and flag end-of-life operating systems.

_Use this to answer 'how many machines are still on an EOL OS' or 'what is the OS mix' in one call instead of paging every agent._

``bash atera-cli agents inventory --eol --agent ``

• `alerts triage` - Group open alerts by severity and customer, ranked by age, so the loudest problems surface first.

_Use this to decide what to work first when the alert queue is noisy._

``bash atera-cli alerts triage --agent ``

• `agents patch-status` - Roll up missing-patch counts across the whole estate, ranked by agent and customer, from the per-device patch endpoints.

_Reach for this when an agent asks which machines or customers are furthest behind on patches - no single API call answers it._

``bash atera-cli agents patch-status --limit 20 --agent ``

• `agents noisy` - Rank the machines and customers generating the most alerts over a window - the chronic problem devices.

_Reach for this when an agent asks which devices keep alerting - alert-volume-by-machine over time, distinct from triaging the current queue._

``bash atera-cli agents noisy --days 7 --agent ``

Service-desk intelligence

• `tickets sla` - Rank open tickets by how close they are to breaching first-response or resolution SLA.

_Pick this for 'what's about to breach SLA' - it computes time-to-breach the API never returns._

``bash atera-cli tickets sla --agent ``

• `tickets workload` - Group open tickets and total logged duration by technician to spot who is overloaded.

_Reach for this before reassigning work - it shows real open-ticket load per tech._

``bash atera-cli tickets workload --agent ``

Book of business

• `customers book` - Per-customer rollup of agent count and contract mix (types + active/inactive) by joining customers, contracts, and agents.

_Use this for account reviews - which customers are under contract vs. ad-hoc, and what each is worth._

``bash atera-cli customers book --agent ``

• `customers coverage` - Find under-contracted customers - managed agents with no active recurring or monitoring contract - before the renewal conversation.

_Reach for this when an agent asks which customers are under-contracted or where revenue is leaking - it is the actionable gap filter, not the full rollup._

``bash atera-cli customers coverage --agent ``

• `contracts expiring` - See which contracts end inside a window, ranked by days-to-expiry and joined to the customer name.

_Reach for this when an agent asks what is up for renewal - a time-window ranking the live API cannot express._

``bash atera-cli contracts expiring --days 60 --agent ``

Time-windowed awareness

• `since` - Show what was created in a time window - new agents, new tickets, new alerts - across the synced estate.

_Pick this for a stand-up summary of what was created across the whole account since yesterday._

``bash atera-cli since 24h --agent ``

Command Reference

account - Manage account

• atera-cli account - Get info

agents - Manage agents

• atera-cli agents delete - Deletes an agent. Requires the agent ID.
• atera-cli agents get - Returns a list of agents.
• atera-cli agents get-by-customer - Returns agents for a specified customer. Requires the customer ID.
• atera-cli agents get-by-machine-name - Returns agents installed on a specified machine. Requires the machine name.
• atera-cli agents query-dto - Returns an agent. Requires the agent ID.

alerts - Manage alerts

• atera-cli alerts delete - Deletes a specified alert. Requires the alert ID.
• atera-cli alerts get - Returns a list of alerts.
• atera-cli alerts get-alertid - Returns an alert. Requires the alert ID.
• atera-cli alerts post - Creates a new alert. Requires the device's global unique identifier (GUID).
• atera-cli alerts resolve - Resolve a specified alert. Requires the alert ID.

billing - Manage billing

• atera-cli billing get - Returns a list of invoices.
• atera-cli billing invoice-query-dto - Returns a specified invoice. Requires the invoice number.

contacts - Manage contacts

• atera-cli contacts delete - Deletes the contact. Requires the contact ID.
• atera-cli contacts get - Accepts whole or partial emails / phone numbers.
• atera-cli contacts get-contactid - Returns the specified contact. Requires the contact ID.
• atera-cli contacts post - Creates a new contact for an existing customer. Requires the customer ID or the customer name.
• atera-cli contacts put - Updates an existing contact. Requires the contact ID.
• atera-cli contacts put-contactid - Updates an existing contact. Requires the contact ID.

contracts - Manage contracts

• atera-cli contracts get - Returns a list of contracts.
• atera-cli contracts get-by-customer - Returns a list of contracts. Requires the customer ID.
• atera-cli contracts post - Creates a new customer. Requires the customer name.
• atera-cli contracts query-dto - Returns a specified contract. Requires the contract ID.
• atera-cli contracts update - Updates an existing contract. Requires the contract ID.
• atera-cli contracts update-contractid - Updates an existing contract. Requires the contract ID.

customers - Manage customers

• atera-cli customers delete - Deletes a specified customer. Requires the customer ID.
• atera-cli customers get - Returns a list of customers.
• atera-cli customers get-customerid - Returns a specified customer. Requires the customer ID.
• atera-cli customers post - Creates a new customer. Requires the customer name.
• atera-cli customers post-attachments - Requires the customer ID and attachment name, including the file extension.
• atera-cli customers post-folders - Requires the folder name and customer ID.
• atera-cli customers put - Updates an existing customer. Requires the customer ID.
• atera-cli customers put-customerid - Updates an existing customer. Requires the customer ID.

customvalues - Manage customvalues