MCP tools
The 131 tools the Nurama MCP server exposes, with their input schemas.
Every tool below is served by the Nurama MCP server (see the MCP guide for setup). Tool names, descriptions and input schemas are exactly what the server returns from tools/list; the raw catalogue is available at /mcp-tools.json.
| Tool | Mutating | Summary |
|---|---|---|
acknowledge_task | yes | Toggle the calling user's acknowledgement of a task (mark as seen, or un-mark). |
add_chat_members | yes | Invite users to a member chat — turns a 1:1 DM into a group chat, or grows an existing group. |
add_column | yes | Append a new column to a board. |
add_existing_task_to_board | yes | Attach an existing task to a board (e.g. |
add_items_to_submission | yes | Add creator-tier paths to an existing submission. |
archive_member_chat | yes | Archive a member chat — hides it from the active list without losing history. |
complete_convo | yes | End a live conversation for everyone — closes the Daily.co room, stamps endedAt, transitions status to completed, and triggers recording / transcript post-processing if those features were enabled |
create_ai_chat_topic | yes | Create a new (empty) AI chat topic — one of Nu's LLM-assistant conversations. |
create_asset_short_link | yes | Mint a deep-linkable short URL for an asset. |
create_board | yes | Create a kanban board in a project. |
create_folder | yes | Create a folder inside a project. |
create_member_chat | yes | Start a private member chat — 1:1 DM (one memberId) or group chat (multiple memberIds). |
create_message_short_link | yes | Mint a deep-linkable short URL for a chat message. |
create_reaction | yes | Add an emoji reaction to a message. |
create_submission | yes | Bundle a set of items at given creator-tier paths into a submission for reviewer review. |
create_tag | yes | Mint a new tag on a workspace or project. |
create_task | yes | Create a new task on a board. |
create_task_relation | yes | Attach a task to a chat or a chat message — establishes the "this task came from / belongs to this conversation" link that the Nurama web app renders as a task card in the conversation. |
delete_ai_chat_topic | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_asset | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_board | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_chat | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_column | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_convo | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_folder | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_items_at_path | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_member_chat | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_message | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_submission_items | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_tag | yes | DESTRUCTIVE — confirm with the user before calling. |
delete_task_relation | yes | DESTRUCTIVE — confirm with the user before calling. |
download_assets | no | Mint signed download URLs for one or more assets — the same URLs the Nurama web app's "Download" button uses. |
follow_chat | yes | Start following a chat — opts the caller in to real-time notifications for every new message in it. |
follow_task | yes | Have the calling user follow a task — they will receive notifications about future activity on it. |
get_addable_chat_members | no | List users who can be invited to a member chat — already filtered by chat scope (workspace / project / social) and excluding current members. |
get_ai_chat_topic | no | Fetch a single AI chat topic by id. |
get_asset | no | Fetch a single asset's metadata by id — name, mediaType, sizeInBytes, status, tags, chats, etc. |
get_asset_access_activity | no | Read play / download access metrics for a single asset (totals + time-series). |
get_asset_files | no | Get the file records of one functionType for an asset (e.g. |
get_board | no | Fetch a single board with its columns and tasks grouped per column. |
get_board_tasks | no | List tasks on one specific board, with optional column / status / assignee / tag filters. |
get_chat | no | Fetch the metadata for a single chat: chatType (topic / member / submission), topicType (project / asset / task / etc.), topicId, visibility, and participant ids. |
get_chat_by_topic_id | no | Resolve a topic id (asset, project, task, public) + visibility into the chat that hangs off it. |
get_convo | no | Fetch a single live conversation (video / audio huddle) by id. |
get_folder | no | Fetch a single folder's metadata by id — name, parent folderId, path, owner project, etc. |
get_member_chat | no | Fetch a single member chat (DM / group chat) by id. |
get_message | no | Fetch a single chat message by id, including attachments, mentions, and reply metadata. |
get_new_notification_count | no | Return the count of new (unread) notifications across the given channels — the cheapest probe to decide whether it's worth paging through list_new_notifications. |
get_project | no | Fetch a single project's metadata — name, slug, description, logo, workspaceId, status. |
get_project_chat | no | Resolve the project-level chat for one visibility tier (creator or reviewer). |
get_public_download_url | no | Return a signed download URL for a public-download token — what a nurma.link page actually redirects to when the user clicks Download. |
get_replies | no | Load the threaded replies under one message. |
get_self | no | Get the bot's own public profile — id, displayName, avatar, color, accountType. |
get_submission | no | Fetch a single submission package by id, including its metadata. |
get_task_links | no | List every task-link record attached to a single task — i.e. |
get_unacknowledged_task_count | no | Return the count of tasks assigned to the calling identity that have not yet been acknowledged, scoped to a project. |
get_workspace | no | Fetch a single workspace's metadata by id — name, slug, color, description, settings (including AI feature toggles), status. |
highlight_message | yes | Pin / highlight a message in its chat — surfaces it in the highlights list and visually flags it in the timeline. |
join_convo | yes | Join an active live conversation. |
leave_convo | yes | Leave a convo while it stays active for the other participants. |
link_task | yes | Create a relationship between two tasks (related, blocks, blockedBy, duplicate). |
list_ai_chat_topics | no | List the caller's AI chat topics (Nu — Nurama's LLM assistant — conversations, separate from project chats). |
list_chat_messages | no | List recent messages in a chat, newest first. |
list_chat_task_relations | no | List task relations anchored in a chat — every task that was created from a message in this chat, or otherwise linked to it. |
list_folder_assets | no | List the assets directly inside a folder. |
list_items_at_path | no | List the file-system items (folders and assets, intermingled) at a path in a project's virtual file system. |
list_mentionable_assets | no | List assets that can be referenced via {{assetMention:UUID}} tokens in a message in this chat. |
list_mentionable_folders | no | List folders the caller can {{folderMention:UUID}} in this chat — already scope-filtered to the chat's visibility tier. |
list_mentionable_tasks | no | List tasks that can be referenced via {{taskMention:UUID}} tokens in a message in this chat. |
list_message_task_relations | no | List task relations attached to one chat message — every task that was created from this message or otherwise linked to it. |
list_my_member_chats | no | List the caller's member chats — 1:1 DMs and group chats. |
list_my_memberships | no | List every workspace, project, and chat the bot user is a member of, with the roles granted on each. |
list_my_mentions | no | List chat messages that mention the calling user, across every chat the user can see. |
list_my_tasks | no | List tasks assigned to the bot user (or, in DANGEROUSLY_USE_USER_JWT mode, to the human user). |
list_new_notifications | no | List notifications NEW since the caller's last-seen timestamp on the given channels. |
list_notifications | no | List notifications on one or more channels (cursor paginated). |
list_project_assets | no | Flat list of assets in a project, scoped to one visibility tier. |
list_project_boards | no | List the boards in a project, optionally filtered to one visibility tier. |
list_project_feed | no | List recent assets in a project, scoped to one visibility tier (creator or reviewer). |
list_project_memberships | no | List every user who has any membership in this project, with their roles. |
list_project_mentionable_users | no | List users who can be @-mentioned in a project chat at the given visibility tier. |
list_project_tasks | no | List tasks across a project, with optional filters by board, column, status, assignee, or substring search on the subject. |
list_scope_convos | no | List live conversations attached to a scope (a project today) at the given visibility tier(s). |
list_submissions | no | List submission packages in a project. |
list_tags | no | List every tag defined for an owner resource — project or workspace. |
list_task_events | no | List the audit / activity events for a single task — status changes, assignments, column moves, comments, etc. |
list_task_relations | no | List the chat / message relations attached to a task. |
list_workspace_projects | no | List every project in a workspace the bot can see — name, slug, id, status. |
move_task | yes | Move a task. |
publish_items | yes | Publish (creator → reviewer tier) one or more resources by id. |
rejoin_convo | yes | Re-enter a convo as an already-active participant. |
remove_attachment | yes | Remove a single asset attachment from a chat message. |
remove_chat_members | yes | Remove users from a member chat. |
remove_reaction | yes | Remove the caller's reaction from a message. |
remove_task_from_board | yes | Detach a task from its board without deleting the task. |
reorder_columns | yes | Bulk-assign new sort orders to columns on a board. |
repair_assets | yes | Re-trigger post-processing (thumbnails, transcoding, metadata extraction) for one or more assets. |
resolve_public_download | no | Resolve a public-download token (the 10-character code at the end of a nurma.link download URL) to minimal file metadata — fileName, mediaType, status. |
resolve_shortlink | no | Resolve a Nurama short-link code (the trailing segment of a https://nurma.link/... |
revise_message | yes | Edit a chat message. |
send_message | yes | Post a new chat message as the bot user. |
start_convo | yes | Start a new live conversation (video or audio huddle) anchored in a chat. |
tag_asset | yes | Apply a tag to an asset. |
tag_board | yes | Apply a tag to a board. |
tag_folder | yes | Apply a tag to a folder. |
tag_submission | yes | Apply a tag to a submission. |
tag_task | yes | Attach a project-scoped tag to a task. |
unarchive_member_chat | yes | Restore an archived member chat to the active list. |
unfollow_chat | yes | Stop following a chat. |
unfollow_task | yes | Have the calling user stop following a task — no further notifications about its activity. |
unhighlight_message | yes | Remove the highlight / pin from a message. |
unlink_task | yes | Remove an existing relationship between two tasks. |
unpublish_items | yes | Unpublish (remove from reviewer tier) one or more resources. |
untag_asset | yes | Remove a tag from an asset. |
untag_board | yes | Remove a tag from a board. |
untag_folder | yes | Remove a tag from a folder. |
untag_submission | yes | Remove a tag from a submission. |
untag_task | yes | Remove a project-scoped tag from a task. |
update_ai_chat_topic | yes | Rename an AI chat topic or toggle its archived state. |
update_asset | yes | Update an asset's name, folder placement, or metadata. |
update_board | yes | Rename, redescribe, retier, archive, or reorder a board. |
update_chat_subject | yes | Rename a chat. |
update_column | yes | Rename, recolor, retag, or reposition a single board column. |
update_convo | yes | Rename a convo or update its notes. |
update_folder_name | yes | Rename a folder. |
update_member_chat | yes | Update a member chat's subject or color. |
update_project | yes | Rename or redescribe a project. |
update_submission | yes | Rename / redescribe / re-version a submission. |
update_tag | yes | Rename or recolor a tag. |
update_task_details | yes | Update a task's subject, description, or assignee. |
update_task_status | yes | Set a task's top-level status to pending, complete, or cancelled. |