Super Magic Tool Reference

Availability: This is the canonical reference for every tool Super Magic can use — in Inbox chat and over the Thread MCP server (the two surfaces expose the same tools under the same names, filtered by the same permissions).

How to read this reference

Column	Meaning
Tool	The tool id (identical in-product and over MCP)
Type	Read (never prompts) or Write (always shows a Confirm action card)
Gating	What controls whether a member sees this tool

Gating values: Always on (every member, cannot be disabled) · Write toggle (on/off per tool; member must also pass the write-access level) · Admin-only · Integration (configured + toggle on; some are Limited release) · Platform (managed by Thread).

Tickets

Tool	Type	Gating	Notes
search_tickets	Read	Always on	Filters: keywords, client, board, state, dates, priority, contact, member, sentiment; single-ticket lookup by internal or PSA id; optional full message thread (see note below on note visibility); count-only mode
list_boards	Read	Always on	Resolves board names → ids
list_ticket_statuses	Read	Always on	Statuses valid for a board
list_ticket_priorities	Read	Always on
list_ticket_categories	Read	Autotask workspaces only — hidden elsewhere	The workspace’s active ticket categories; resolves names → ids for set_ticket_category
list_recap_templates	Read	Always on	Recap templates available to the workspace
create_ticket	Write	Write toggle	Requires title, board, client; optional contact/assignee
update_ticket	Write	Write toggle	Title, status, priority, board, member assignee (assign/unassign)
assign_contact	Write	Write toggle	Assign, change, or unassign the ticket’s contact (requester) — resolve with search_contacts first
set_ticket_category	Write	Write toggle · Autotask workspaces only	Sets the ticket’s PSA category; pair with list_ticket_categories
add_ticket_note	Write	Write toggle	Internal (staff-only) or external (client-visible, synced to PSA)
merge_ticket	Write	Write toggle	ConnectWise workspaces only — hidden elsewhere
send_approval	Write	Write toggle	Emails a contact to approve/decline — route to specific contacts or by contact type
log_time_entry	Write	Write toggle	Records time in the PSA, optionally marked as the resolution
run_assistive_ai	Write	Write toggle	Auto title / priority / categorization / recap in a single call

Scheduling

Tool	Type	Gating	Notes
list_schedule_entries	Read	Always on	Lists a ticket’s existing schedule entries
schedule_ticket	Write	Write toggle	Books a technician to a date/time — lands on the Planner + PSA dispatch calendar (does not write to Outlook)
update_schedule_entry	Write	Write toggle	Modify, reassign, mark done, or delete an entry

Bounds for mass operations: chained requests run up to ~30 agent steps per message, and search_tickets returns up to 100 tickets per call (20 by default; up to 10 when full message threads are included). Batch bigger jobs in chunks.

What search_tickets reads from a ticket’s thread: when search_ticket_notes is true, keyword matching and returned message text cover the last 10 client and technician messages on the ticket. It does not read internal notes (staff-only notes, including the internal notes written by log_time_entry) and it does not read PSA time-entry records. Super Magic has no read tool for time entries — log_time_entry writes them but nothing surfaces the existing entries back. If you need time-entry data (including internal time notes), pull it from your PSA directly.

Search & lookups

Tool	Type	Gating	Notes
search_clients	Read	Always on	Resolves client companies → ids
search_contacts	Read	Always on	People at a client; includes learned contact memory
search_members	Read	Always on	Workspace staff
search_thread_docs	Read	Always on	Thread product documentation
search_knowledge_base	Read	(Limited release)	Workspace KB + resolved-ticket history
search_itglue	Read	Integration (Limited release)	IT Glue documentation
search_hudu	Read	Integration (Limited release)	Hudu KB, passwords, network docs
web_search	Read	Platform	Live web results (error codes, CVEs, vendor docs)

IT Glue write (where enabled): push_knowledge_to_itglue (Write) exports a resolved-ticket knowledge article into IT Glue. It only appears where IT Glue is connected, its Super Magic access is on, and IT Glue export is enabled for the workspace — so most workspaces see IT Glue as read-only search only.

Intents — admin-only

Tool	Type	Gating
list_intents	Read	Admin-only
get_intent	Read	Admin-only
create_intent	Write	Admin-only + write toggle ( intent_tools )
update_intent	Write	Admin-only + write toggle ( intent_tools )
update_variation	Write	Admin-only + write toggle ( intent_tools )
set_variation_replies	Write	Admin-only + write toggle ( intent_tools )
set_variation_arguments	Write	Admin-only + write toggle ( intent_tools )

Flows — admin-only

Tool	Type	Gating
list_flows	Read	Admin-only
get_flow	Read	Admin-only
create_flow	Write	Admin-only + write toggle ( flow_tools )
update_flow	Write	Admin-only + write toggle ( flow_tools )
list_flow_actions	Read	Admin-only
list_flow_filter_attributes	Read	Admin-only
list_flow_filter_attribute_values	Read	Admin-only

NinjaOne — integration (Limited release)

Requires: NinjaOne configured by an admin and the member signed in with their own NinjaOne account. Tools act with that member’s NinjaOne permissions.

Tool	Type	Notes
list_ninjaone_organizations	Read	Client orgs in NinjaOne
search_ninjaone_devices	Read	Filter by `organization_id`, a text `query` (matches device name or last-logged-in user), and/or `device_class` — any one is enough. `device_class` accepts exact NinjaOne classes (`LINUX_SERVER`, `WINDOWS_WORKSTATION`, `NMS_FIREWALL`, …) or group words that expand to several (`SERVER`, `WORKSTATION`, `LINUX`, `WINDOWS`, `MACOS`, `NETWORK_DEVICE`, …); plurals like “Linux servers” work. When combined with `query`, filtering is by class first, then the text is matched in memory over that set. A `device_class` search never falls back to a global name search.
get_ninjaone_device	Read	Device detail
get_ninjaone_device_link	Read	Deep link to the device in NinjaOne
get_ninjaone_device_activities	Read	Recent device activity
list_ninjaone_alerts	Read
list_ninjaone_windows_services	Read
reboot_ninjaone_device	Write
set_ninjaone_device_maintenance	Write	Maintenance mode on/off
reset_ninjaone_alert	Write
control_ninjaone_windows_service	Write	Start/stop/restart a Windows service
set_ninjaone_device_approval	Write	Approve/reject a device

TimeZest — integration

Tool	Type	Notes
list_timezest_resources	Read
list_timezest_appointment_types	Read
create_timezest_scheduling_request	Write	Sends a real scheduling email to the contact
get_timezest_scheduling_requests	Read

Liongard — integration (Limited release)

Liongard tools are fetched dynamically from your Liongard instance, so the exact list depends on what Liongard exposes (environments, systems, metrics, alerts, detections, timelines, reports). All Liongard tools are reads. Liongard is also offered as a per-member connector.

ImmyBot — integration (Limited release)

Requires: ImmyBot configured by an admin and its Super Magic access toggled on. ImmyBot is workspace-level — there is no per-member sign-in; every member sees the same ImmyBot context.

Tool	Type	Notes
list_immybot_tenants	Read	Client tenants in ImmyBot
search_immybot_computers	Read
get_immybot_computer	Read	Computer detail
list_immybot_maintenance_sessions	Read	Recent maintenance sessions
run_immybot_maintenance_session	Write	Runs an ImmyBot maintenance session — behind the Confirm action card

Dispatch (where enabled)

Tool	Type	Gating	Notes
get_next_thread	Write	Write toggle · available where Auto-Dispatch is enabled	Pulls the next highest-priority ticket from your Auto-Dispatch queue and assigns it to you, like the “Get thread” button in Inbox. Interactive chat only — never runs in an unattended Flow

See Super Magic and Integrations updates in the changelog.

Thread Inbox

Messenger

Companion Apps

Voice AI

Magic AI

Magic Agents

Super Magic

Service Intelligence

Magic Analytics

Automation

Integrations

Workspace administration

Notifications

Security & compliance

Plans & billing

Super Magic Tool Reference

How to read this reference

Tickets

Scheduling

Search & lookups

Intents — admin-only

Flows — admin-only

NinjaOne — integration (Limited release)

TimeZest — integration

Liongard — integration (Limited release)

ImmyBot — integration (Limited release)

Dispatch (where enabled)

​How to read this reference

​Tickets

​Scheduling

​Search & lookups

​Intents — admin-only

​Flows — admin-only

​NinjaOne — integration (Limited release)

​TimeZest — integration

​Liongard — integration (Limited release)

​ImmyBot — integration (Limited release)

​Dispatch (where enabled)

How to read this reference

Tickets

Scheduling

Search & lookups

Intents — admin-only

Flows — admin-only

NinjaOne — integration (Limited release)

TimeZest — integration

Liongard — integration (Limited release)

ImmyBot — integration (Limited release)

Dispatch (where enabled)