From atera
Manages Atera RMM agents by listing, searching, monitoring status, executing PowerShell commands, and handling lifecycle on managed endpoints for MSP technicians.
npx claudepluginhub wyre-technology/msp-claude-plugins --plugin ateraThis skill uses the workspace's default tool permissions.
Atera agents are lightweight software installed on managed endpoints that provide remote monitoring and management capabilities. Agents report system information, health metrics, and enable remote execution of scripts and commands.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Generates or updates index.md listing all files and subdirectories in a target folder with 3-10 word descriptions from file contents. Use for indexing documentation directories.
Atera agents are lightweight software installed on managed endpoints that provide remote monitoring and management capabilities. Agents report system information, health metrics, and enable remote execution of scripts and commands.
| Field | Type | Description |
|---|---|---|
AgentID | int | Unique agent identifier |
AgentName | string | Agent display name |
MachineID | int | Machine reference ID |
CustomerID | int | Associated customer ID |
CustomerName | string | Customer display name |
Online | boolean | Current online status |
LastSeenDate | datetime | Last communication timestamp |
| Field | Type | Description |
|---|---|---|
MachineName | string | Computer hostname |
DomainName | string | AD domain (if joined) |
OS | string | Operating system name |
OSVersion | string | OS version/build |
OSType | string | Windows, Mac, Linux |
OSSerialNumber | string | OS serial number |
Processor | string | CPU model |
Memory | long | Total RAM in bytes |
| Field | Type | Description |
|---|---|---|
IPAddresses | string | Comma-separated IP list |
MacAddresses | string | Network adapter MACs |
LastIPAddress | string | Most recent IP |
| Field | Type | Description |
|---|---|---|
AgentVersion | string | Installed agent version |
CreatedDate | datetime | When agent was installed |
Monitored | boolean | Monitoring enabled |
MonitoredStatus | string | Monitoring state |
Favorite | boolean | Marked as favorite |
| Field | Type | Description |
|---|---|---|
Vendor | string | Hardware manufacturer |
VendorSerialNumber | string | Device serial number |
VendorModel | string | Device model |
VendorBrandModel | string | Full brand/model string |
GET /api/v3/agents?page=1&itemsInPage=50
X-API-KEY: {api_key}
Response:
{
"items": [
{
"AgentID": 98765,
"AgentName": "DESKTOP-ABC123",
"MachineName": "DESKTOP-ABC123",
"CustomerID": 12345,
"CustomerName": "Acme Corporation",
"Online": true,
"LastSeenDate": "2024-02-15T14:30:00Z",
"OS": "Windows 11 Pro",
"OSType": "Windows",
"Processor": "Intel Core i7-12700",
"Memory": 34359738368,
"IPAddresses": "192.168.1.100,10.0.0.50",
"AgentVersion": "2.0.1.25",
"Monitored": true
}
],
"totalItems": 500,
"page": 1,
"itemsInPage": 50,
"totalPages": 10
}
GET /api/v3/agents/{agentId}
X-API-KEY: {api_key}
Response:
{
"AgentID": 98765,
"AgentName": "DESKTOP-ABC123",
"MachineName": "DESKTOP-ABC123",
"DomainName": "ACME.LOCAL",
"CustomerID": 12345,
"CustomerName": "Acme Corporation",
"Online": true,
"LastSeenDate": "2024-02-15T14:30:00Z",
"OS": "Windows 11 Pro",
"OSVersion": "10.0.22621",
"OSType": "Windows",
"OSSerialNumber": "00330-80000-00000-AA123",
"Processor": "Intel(R) Core(TM) i7-12700 CPU @ 2.10GHz",
"Memory": 34359738368,
"IPAddresses": "192.168.1.100",
"MacAddresses": "00:1A:2B:3C:4D:5E",
"Vendor": "Dell Inc.",
"VendorSerialNumber": "ABC1234567",
"VendorModel": "OptiPlex 7090",
"AgentVersion": "2.0.1.25",
"CreatedDate": "2023-06-15T09:00:00Z",
"Monitored": true,
"MonitoredStatus": "Healthy"
}
GET /api/v3/agents/customer/{customerId}
X-API-KEY: {api_key}
GET /api/v3/agents/machine/{machineName}
X-API-KEY: {api_key}
DELETE /api/v3/agents/{agentId}
X-API-KEY: {api_key}
Response:
{
"ActionID": 12345,
"Success": true
}
POST /api/v3/agents/{agentId}/powershell
X-API-KEY: {api_key}
Content-Type: application/json
{
"Script": "Get-Service | Where-Object {$_.Status -eq 'Running'} | Select-Object Name, DisplayName"
}
Response:
{
"ActionID": 55555,
"Status": "Queued",
"Message": "Script queued for execution"
}
Get system information:
Get-ComputerInfo | Select-Object CsName, WindowsVersion, OsArchitecture
Check disk space:
Get-WmiObject Win32_LogicalDisk | Select-Object DeviceID, Size, FreeSpace
List running processes:
Get-Process | Sort-Object WorkingSet -Descending | Select-Object -First 10 Name, WorkingSet
Check Windows updates:
Get-HotFix | Sort-Object InstalledOn -Descending | Select-Object -First 5
Restart a service:
Restart-Service -Name "Spooler" -Force
The Online field indicates current connectivity:
| Status | Description | Action |
|---|---|---|
true | Agent communicating | Commands available |
false | Agent not responding | Check network/power |
| Duration | Interpretation | Action |
|---|---|---|
| < 5 min | Temporary | Normal fluctuation |
| 5-30 min | Short outage | Monitor |
| 30 min - 4 hr | Extended outage | Investigate |
| > 4 hr | Long-term offline | Contact customer |
| Code | Message | Resolution |
|---|---|---|
| 400 | Invalid agent ID | Verify agent exists |
| 401 | Unauthorized | Check API key |
| 403 | Forbidden | Verify permissions |
| 404 | Agent not found | Confirm agent ID |
| 429 | Rate limited | Wait and retry (700 req/min) |
| Error | Cause | Resolution |
|---|---|---|
| Agent offline | Device not connected | Wait for reconnection |
| Script timeout | Execution too long | Simplify script |
| Access denied | Insufficient privileges | Check agent permissions |
| Syntax error | Invalid PowerShell | Validate script locally |