Atera MCP by usefulapi MCP server

atera_add_ticket_comment

Add a comment to a ticket, either as a technician (technician_id, with is_internal=true for a private note or false for a reply the end user sees) or on behalf of an end user (enduser_id). Atera: POST /api/v3/tickets/{ticketId}/comments.

destructive

Argument	Type	Description
comment*	string	The comment text.
ticket_id*	integer	The ticket's TicketID.
enduser_id	integer	Post as this end-user contact (EndUserID).
is_internal	boolean	Technician comments only: true = internal note (default), false = visible reply.
technician_id	integer	Post as this technician (TechnicianId).
timestamp_utc	string	Comment time in UTC, ISO 8601. Defaults to now.
technician_email	string	The technician's email (optional, with technician_id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ticket_id",
    "comment"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "minLength": 1,
      "description": "The comment text."
    },
    "ticket_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The ticket's TicketID.",
      "exclusiveMinimum": 0
    },
    "enduser_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Post as this end-user contact (EndUserID).",
      "exclusiveMinimum": 0
    },
    "is_internal": {
      "type": "boolean",
      "default": true,
      "description": "Technician comments only: true = internal note (default), false = visible reply."
    },
    "technician_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Post as this technician (TechnicianId).",
      "exclusiveMinimum": 0
    },
    "timestamp_utc": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
      "description": "Comment time in UTC, ISO 8601. Defaults to now."
    },
    "technician_email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The technician's email (optional, with technician_id)."
    }
  }
}

atera_create_contact

Create a new end-user contact under an existing customer (give customer_id or customer_name). Atera: POST /api/v3/contacts.

destructive

Argument	Type	Description
email*	string	The contact's email (required).
phone	string
job_title	string
last_name	string
first_name	string
customer_id	integer	The customer's CustomerID.
mobile_phone	string
customer_name	string	The customer's name, if you don't have the id.
is_contact_person	boolean	Mark as the customer's primary contact person.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The contact's email (required)."
    },
    "phone": {
      "type": "string"
    },
    "job_title": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "first_name": {
      "type": "string"
    },
    "customer_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The customer's CustomerID.",
      "exclusiveMinimum": 0
    },
    "mobile_phone": {
      "type": "string"
    },
    "customer_name": {
      "type": "string",
      "description": "The customer's name, if you don't have the id."
    },
    "is_contact_person": {
      "type": "boolean",
      "description": "Mark as the customer's primary contact person."
    }
  }
}

atera_create_ticket

Open a new helpdesk ticket. Give either end_user_id (an existing contact's EndUserID) or all of end_user_first_name, end_user_last_name and end_user_email to create a new contact with it. Atera: POST /api/v3/tickets.

destructive

Argument	Type	Description
type	string
title*	string	Ticket title.
impact	string
status	string	Ticket status name, e.g. Open, Pending, Resolved or Closed (or a custom status).
priority	string
description*	string	Ticket description (first comment).
end_user_id	integer	Existing contact's EndUserID.
end_user_email	string	New contact's email.
end_user_phone	string	New contact's phone.

atera_find_agents_by_machine

Find the agent(s) installed on a machine by its machine name, e.g. DESKTOP-4F2K9. Atera: GET /api/v3/agents/machine/{machineName}.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
machine_name*	string	The machine (computer) name.
items_in_page	integer	Items per page, 1-500 (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "machine_name"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "machine_name": {
      "type": "string",
      "minLength": 1,
      "description": "The machine (computer) name."
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Items per page, 1-500 (default 20)."
    }
  }
}

atera_get_account

Fetch the Atera account this key belongs to — company name, plan, country and timezone. A cheap way to confirm the key works. Atera: GET /api/v3/account.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

atera_get_agent

Fetch a single agent by its AgentID — full device inventory, online status, IPs, OS build and last reboot. Atera: GET /api/v3/agents/{agentId}.

read-only

Argument	Type	Description
agent_id*	integer	The agent's AgentID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The agent's AgentID.",
      "exclusiveMinimum": 0
    }
  }
}

atera_get_agent_patches

List the Windows/OS patches on one device — either those still AVAILABLE (missing) or those already INSTALLED. Takes the device's DeviceGuid (from atera_list_agents / atera_get_agent), not the AgentID. Atera: GET /api/v3/agents/{deviceGuid}/available-patches or /installed-patches.

read-only

Argument	Type	Description
kind	string	available = patches not yet installed (default); installed = patch history.
device_guid*	string	The device's DeviceGuid.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "device_guid"
  ],
  "properties": {
    "kind": {
      "enum": [
        "available",
        "installed"
      ],
      "type": "string",
      "default": "available",
      "description": "available = patches not yet installed (default); installed = patch history."
    },
    "device_guid": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The device's DeviceGuid."
    }
  }
}

atera_get_customer

Fetch a single customer by id — address, domain, phone, notes. Atera: GET /api/v3/customers/{customerId}.

read-only

Argument	Type	Description
customer_id*	integer	The customer's CustomerID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "customer_id"
  ],
  "properties": {
    "customer_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The customer's CustomerID.",
      "exclusiveMinimum": 0
    }
  }
}

atera_get_ticket

Fetch a single ticket by its TicketID. Atera: GET /api/v3/tickets/{ticketId}.

read-only

Argument	Type	Description
ticket_id*	integer	The ticket's TicketID.
include_relations	boolean	Include parent/child ticket relation info.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ticket_id"
  ],
  "properties": {
    "ticket_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The ticket's TicketID.",
      "exclusiveMinimum": 0
    },
    "include_relations": {
      "type": "boolean",
      "description": "Include parent/child ticket relation info."
    }
  }
}

atera_list_agents

List Atera agents — the managed machines — with online status, last seen, OS, hardware and logged-in user. Pass customer_id to list only one customer's devices. Atera: GET /api/v3/agents or GET /api/v3/agents/customer/{customerId}.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
customer_id	integer	Only this customer's agents.
items_in_page	integer	Items per page, 1-500 (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "customer_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this customer's agents.",
      "exclusiveMinimum": 0
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Items per page, 1-500 (default 20)."
    }
  }
}

atera_list_alerts

List monitoring alerts (disk, CPU, availability, hardware...) with severity, device, customer and linked ticket. Filter by status. Atera: GET /api/v3/alerts.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
alert_status	string	Only alerts in this state.
items_in_page	integer	Items per page, 1-500 (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "alert_status": {
      "enum": [
        "Open",
        "Resolved",
        "Snoozed"
      ],
      "type": "string",
      "description": "Only alerts in this state."
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Items per page, 1-500 (default 20)."
    }
  }
}

atera_list_contacts

List end-user contacts, optionally searching by whole or partial email or phone number. Atera: GET /api/v3/contacts.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
email	string	Whole or partial email to match.
phone	string	Whole or partial phone number to match.
items_in_page	integer	Items per page, 1-500 (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "email": {
      "type": "string",
      "description": "Whole or partial email to match."
    },
    "phone": {
      "type": "string",
      "description": "Whole or partial phone number to match."
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Items per page, 1-500 (default 20)."
    }
  }
}

atera_list_contracts

List service contracts (retainer, block hours, hourly, remote monitoring...) with their rates and billing periods. Pass customer_id for one customer's contracts. Atera: GET /api/v3/contracts or GET /api/v3/contracts/customer/{customerId}.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
customer_id	integer	Only this customer's contracts.
items_in_page	integer	Items per page, 1-500 (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "customer_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this customer's contracts.",
      "exclusiveMinimum": 0
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Items per page, 1-500 (default 20)."
    }
  }
}

atera_list_customers

List the customers (client companies) managed in Atera, paginated. Atera: GET /api/v3/customers.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
items_in_page	integer	Items per page, 1-500 (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Items per page, 1-500 (default 20)."
    }
  }
}

atera_list_kb_articles

List knowledge-base articles with their product, keywords, section, category and ratings. Atera: GET /api/v3/knowledgebases.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
items_in_page	integer	Items per page, 1-500 (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Items per page, 1-500 (default 20)."
    }
  }
}

atera_list_ticket_comments

List the comment thread on one ticket — end-user and technician replies, with internal notes flagged. Atera: GET /api/v3/tickets/{ticketId}/comments.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
ticket_id*	integer	The ticket's TicketID.
items_in_page	integer	Items per page, 1-50 (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ticket_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "ticket_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The ticket's TicketID.",
      "exclusiveMinimum": 0
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Items per page, 1-50 (default 20)."
    }
  }
}

atera_list_ticket_work_hours

List the time entries logged on one ticket — technician, start/end, billable, on-site, rate. Atera: GET /api/v3/tickets/{ticketId}/workhoursrecords.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
ticket_id*	integer	The ticket's TicketID.
items_in_page	integer	Items per page, 1-50 (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ticket_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "ticket_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The ticket's TicketID.",
      "exclusiveMinimum": 0
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Items per page, 1-50 (default 20)."
    }
  }
}

atera_list_tickets

List helpdesk tickets with priority, status, type, end user, technician, SLA durations and last comments. Filter by customer and/or status. Atera: GET /api/v3/tickets.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1).
customer_id	integer	Only this customer's tickets.
items_in_page	integer	Items per page, 1-50 (default 20).
ticket_status	string	Ticket status name, e.g. Open, Pending, Resolved or Closed (or a custom status).
include_relations	boolean	Include parent/child ticket relation info.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, 1-based (default 1)."
    },
    "customer_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this customer's tickets.",
      "exclusiveMinimum": 0
    },
    "items_in_page": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Items per page, 1-50 (default 20)."
    },
    "ticket_status": {
      "type": "string",
      "minLength": 1,
      "description": "Ticket status name, e.g. Open, Pending, Resolved or Closed (or a custom status)."
    },
    "include_relations": {
      "type": "boolean",
      "description": "Include parent/child ticket relation info."
    }
  }
}

atera_resolve_alert

Mark one monitoring alert as resolved. If the underlying condition persists, Atera raises it again on the next check. Atera: PUT /api/v3/alerts/{alertId}.

destructive

Argument	Type	Description
alert_id*	integer	The alert's AlertID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "alert_id"
  ],
  "properties": {
    "alert_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The alert's AlertID.",
      "exclusiveMinimum": 0
    }
  }
}

atera_update_ticket

Change a ticket's title, status, type, priority, impact or assigned technician. Only the fields you pass are sent. Atera: PUT /api/v3/tickets/{ticketId}.

destructive

Argument	Type	Description
type	string
title	string	New title.
impact	string
status	string	Ticket status name, e.g. Open, Pending, Resolved or Closed (or a custom status).
priority	string
ticket_id*	integer	The ticket's TicketID.
technician_email	string	Reassign to the technician with this email.
technician_contact_id	integer	Reassign to this technician (TechnicianContactID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ticket_id"
  ],
  "properties": {
    "type": {
      "enum": [
        "Incident",
        "Problem",
        "Request",
        "Change"
      ],
      "type": "string"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "New title."
    },
    "impact": {
      "enum": [
        "NoImpact",
        "SiteDown",
        "ServerIssue",
        "Minor",
        "Major",
        "Crisis"
      ],
      "type": "string"
    },
    "status": {
      "type": "string",
      "minLength": 1,
      "description": "Ticket status name, e.g. Open, Pending, Resolved or Closed (or a custom status)."
    },
    "priority": {
      "enum": [
        "Low",
        "Medium",
        "High",
        "Critical"
      ],
      "type": "string"
    },
    "ticket_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The ticket's TicketID.",
      "exclusiveMinimum": 0
    },
    "technician_email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Reassign to the technician with this email."
    },
    "technician_contact_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Reassign to this technician (TechnicianContactID).",
      "exclusiveMinimum": 0
    }
  }
}

Atera MCP by usefulapi

Try it

atera_add_ticket_comment

Atera MCP by usefulapi

Try it

atera_add_ticket_comment

Tools (20)