Developer / MCP

MCP tools & troubleshooting

Reference for the tools available when you connect an AI tool (Claude, ChatGPT, Cursor, Gemini CLI, etc.) to your Comm event data. Set up a connection from Account Settings → Developer / MCP access.

Available tools

Read tools work with any key or connection. Write tools need a key or connection that was explicitly granted write access.

Read tools

list_eventsList the account's events (id, name, created_at).
get_event_summaryWhich system types an event has, plus roster/channel/zone/checkout counts.
list_event_usersAn event's user roster.
list_two_way_devicesTwo-way radio device assignments for an event.
list_channelsSPX/DPX channels, grouped by site, for an event.
list_zonesAn event's zones and their radio channel slots.
list_wireless_beltpacksAn event's wireless beltpack roster.
get_unity_programmingAn event's Unity Intercom licence, groups and channels, and each Unity user's access.
list_keypanelsAn event's keypanel roster.
list_wired_beltpacksAn event's wired beltpack roster.
list_conferencesAn event's named matrix conferences.
list_four_wireAn event's named 4-wire circuits, including split circuits' In and Out names.
list_checkout_itemsAn event's Check In/Out catalogue, including current checked-out status.

Write tools (require write access)

create_event_userAdd a new person to an event's roster.
update_event_userUpdate an existing person on an event's roster. Omitted fields are left unchanged; this can't be used to clear a field back to empty.
create_system_nodeDeclare a system type for an event (e.g. riedel_matrix, two_way, wired_beltpack). An event can't have two different matrix brands at once.
set_unity_group_channelSet one of a Unity Intercom group's 6 channels (shared by every Unity user).
set_unity_accessSet a Unity user's access to a channel: talk and listen, listen only, or none.
add_unity_groupAdd a Unity Intercom group, optionally named.
rename_unity_groupRename a Unity Intercom group.
create_checkout_itemsBulk-add physical inventory to an event's Check In/Out catalogue (e.g. 60 Boleros). Max 200 per call.

Endpoint

https://mycomm.app/api/mcp

Common errors and how to fix them

Missing Authorization: Bearer <api key> header.
Your AI tool isn't sending a key at all.
Check your MCP config includes an Authorization: Bearer <your key> header. Create a key from Account Settings → Developer / MCP access.
Invalid or revoked API key.
The key was mistyped, revoked, or an OAuth connection has expired.
Create a new key, or reconnect the app, from Account Settings → Developer / MCP access.
This credential does not have write access.
You're using a read-only key or connection to call a write tool (create_event_user, update_event_user, create_system_node, the Unity tools that set or add something, create_checkout_items).
Create a new key with "Allow this key to create and modify data too" checked, or reconnect the app and grant write access, from Account Settings.
API access requires a Pro or Enterprise plan.
Your account's current plan doesn't include MCP/API access.
Upgrade to Pro or Enterprise to enable it.

Having an account issue instead (login, billing, or anything not related to an AI tool connection?