Chat

atlas_chat_attachment_uploads_finalize

Confirm that the bytes for a chat attachment upload have been sent. For a multipart upload, pass the uploadId and every part with its ETag. The API checks the stored file against the size and type given. Returns the attachment, ready to attach to a message. Only the person who started the upload may finalize it.

Scope

chat:write

Calls

POST /v1/chat/channels/{id}/attachments/{attachmentId}/finalize

Example prompt

Finish the upload of the PDF I just sent.

Arguments

atlas_chat_attachment_uploads_start

Start uploading a file to a chat channel. Returns the new attachment id and where to send the bytes: one presigned PUT URL with the headers to send, or for a large file an uploadId and one presigned URL per part. Put the bytes there, then call atlas_chat_attachment_uploads_finalize, then send a message with the attachment id to share it. The workspace must allow chat attachments, and guests cannot upload.

Scope

chat:write

Calls

POST /v1/chat/channels/{id}/attachments/ticket

Example prompt

Upload this PDF to #launch.

Arguments

atlas_chat_attachments_delete

Delete a file shared in a chat channel. It disappears from the channel and its message for every member. Returns an empty result on success. Only the uploader or a workspace administrator may delete it.

Scope

chat:write

Calls

DELETE /v1/chat/channels/{id}/attachments/{attachmentId}

Example prompt

Delete the screenshot I shared in #launch.

Arguments

atlas_chat_attachments_download

Get a link to download a file shared in a chat channel, or its thumbnail or preview. Returns a short-lived signed URL and the time it expires; fetch the file from that URL. Returns only what the token owner can see, which the API enforces: a channel you are not a member of, or a file still uploading, is refused.

Scope

chat:read

Calls

GET /v1/chat/channels/{id}/attachments/{attachmentId}/download

Example prompt

Get me a download link for the budget spreadsheet in #finance.

Arguments

atlas_chat_attachments_list

List the files shared in a chat channel, newest first, up to 200. Returns each file name, type, size, uploader, the message it belongs to, and whether a thumbnail or preview exists. Returns only what the token owner can see, which the API enforces: a channel you are not a member of is refused.

Scope

chat:read

Calls

GET /v1/chat/channels/{id}/attachments

Example prompt

What files have been shared in #launch?

Arguments

atlas_chat_channel_members_add

Add one or more workspace users to a chat channel by user id. Any member may add people to a public channel; a private channel needs its owner or a workspace administrator, and a direct message cannot take new members. Returns the number of user ids added.

Scope

chat:write

Calls

POST /v1/chat/channels/{id}/members

Example prompt

Add Priya and Tom to #launch.

Arguments

atlas_chat_channel_members_list

List the members of a chat channel with their role (OWNER or MEMBER) and when they joined. Use it to see who will read a message before you post. Returns members only for a channel the token owner belongs to; any other channel is refused.

Scope

chat:read

Calls

GET /v1/chat/channels/{id}/members

Example prompt

Who is in the #launch channel?

Arguments

atlas_chat_channels_create

Create a workspace- or project-scoped chat channel with a name and optional topic, description, privacy flag, and seed members. Project-scoped channels require a projectId. Idempotent per MCP call.

Scope

chat:write

Calls

POST /v1/chat/channels

Example prompt

Create a private #launch-war-room channel for the Mobile project.

Arguments

atlas_chat_channels_get

Return one caller-visible chat channel by id, including scope, name, topic, privacy, archive state, and membership summary.

Scope

chat:read

Calls

GET /v1/chat/channels/{id}

Example prompt

Show me the details of the #general channel.

Arguments

atlas_chat_channels_join

Join a public workspace or project channel as the token owner, so its messages appear in your channel list. Private channels and direct messages cannot be joined this way; a member must add you. Returns the channel you joined.

Scope

chat:write

Calls

POST /chat/channels/{id}/join

Example prompt

Join the #design-reviews channel.

Arguments

atlas_chat_channels_leave

Leave a chat channel as the token owner. You stop receiving its messages and need to rejoin, or be added again for a private channel, to read it. Returns an empty result on success.

Scope

chat:write

Calls

POST /chat/channels/{id}/leave

Example prompt

Leave the #random channel.

Arguments

atlas_chat_channels_list

List the caller-visible chat channels, optionally narrowed by scope (WORKSPACE/PROJECT/DM), project id, or to include archived channels. Returns channel rows with membership + unread metadata so an MCP host can pick where to read or post.

Scope

chat:read

Calls

GET /v1/chat/channels

Example prompt

List my Atlas chat channels with unread messages.

Arguments

atlas_chat_channels_read_mark

Mark a chat channel as read for the token owner, up to a given message or moment, or up to now when neither is given. This clears your unread count and changes nothing for anyone else. Returns the time your read marker now stands at.

Scope

chat:write

Calls

POST /v1/chat/channels/{id}/read

Example prompt

Mark #general as read.

Arguments

atlas_chat_channels_update

Change a chat channel: rename it, set or clear its topic and description, make it private or public, or archive and unarchive it. Send only the fields to change. Returns the updated channel. Only a channel owner or a workspace administrator may change a channel, and a direct message cannot be changed.

Scope

chat:write

Calls

PATCH /v1/chat/channels/{id}

Example prompt

Set the topic of #launch to \"Ship date is 14 October\".

Arguments

atlas_chat_dms_start

Open (or return the existing) direct-message channel with the given user ids. One id opens a 1:1 DM; multiple ids open a group DM. Idempotent per MCP call.

Scope

chat:write

Calls

POST /v1/chat/dms

Example prompt

Start a DM with Priya and Sam.

Arguments

atlas_chat_doc_revisions_get

Read one saved revision of a chat doc. Returns its revision number, title and content as TipTap JSON, so you can compare it with the current doc. Returns only what the token owner can see, which the API enforces: a doc in a channel you cannot read is refused.

Scope

chat:read

Calls

GET /v1/chat/docs/{id}/revisions/{revision}

Example prompt

What did the project brief say at revision 3?

Arguments

atlas_chat_doc_revisions_list

List the saved revisions of a chat doc, newest first, up to the last 50. Returns each revision number, title, author and time. Returns only what the token owner can see, which the API enforces: a doc in a channel you cannot read is refused.

Scope

chat:read

Calls

GET /v1/chat/docs/{id}/revisions

Example prompt

Show the edit history of the decision log doc.

Arguments

atlas_chat_doc_revisions_restore

Restore a chat doc to an earlier revision. The old content is saved forward as a new revision, so nothing in the history is lost. Only the doc creator, a channel owner or a workspace administrator may restore. Returns the doc after the restore.

Scope

chat:write

Calls

POST /v1/chat/docs/{id}/revisions/{revision}/restore

Example prompt

Restore the project brief to revision 3.

Arguments

atlas_chat_doc_shares_remove

Stop sharing a chat doc into a channel or direct message. The doc stays in its home channel. Only the doc creator, a channel owner or a workspace administrator may remove a share. Returns ok on success.

Scope

chat:write

Calls

DELETE /v1/chat/docs/{id}/share/{channelId}

Example prompt

Stop sharing the project brief doc with #marketing.

Arguments

atlas_chat_doc_templates_list

List the templates a chat doc can start from: blank, meeting minutes, meeting notes, decision log, project brief and standup. Returns each template key, name, description, icon and starting content. Use a key as the template when creating a doc.

Scope

chat:read

Calls

GET /v1/chat/doc-templates

Example prompt

What templates can a chat doc start from?

Arguments

This tool takes no arguments.

atlas_chat_docs_archive

Archive a chat doc so it leaves the channel doc list without being deleted. You may archive a doc you created; archiving a doc someone else created needs a channel owner or a workspace administrator. Returns the archived doc. Bring it back with atlas_chat_docs_restore.

Scope

chat:write

Calls

POST /v1/chat/docs/{id}/archive

Example prompt

Archive the old meeting notes doc in #launch.

Arguments

atlas_chat_docs_create

Create a doc in a chat channel or direct message, blank or from a template, with an optional title, icon and starting content. Every member of the channel can open it. Returns the new doc with its content, at revision 0.

Scope

chat:write

Calls

POST /v1/chat/docs

Example prompt

Start a standup doc in #engineering.

Arguments

atlas_chat_docs_delete

Delete a chat doc for good, with all its revisions and shares. It cannot be recovered; archive it instead to keep it. Only the doc creator, a channel owner or a workspace administrator may delete it. Returns ok on success.

Scope

chat:write

Calls

DELETE /v1/chat/docs/{id}

Example prompt

Delete the empty draft doc in #launch.

Arguments

atlas_chat_docs_get

Read one chat doc in full. Returns its title, icon, content as TipTap JSON and as plain text, revision, authorship, archive state and the channels it is shared into. Returns only what the token owner can see, which the API enforces: a doc in a channel you cannot read is refused.

Scope

chat:read

Calls

GET /v1/chat/docs/{id}

Example prompt

Read the project brief doc in #launch.

Arguments

atlas_chat_docs_list

List the docs in a chat channel or direct message, including docs shared into it, most recently edited first. Returns each doc title, icon, a short preview, revision, who edited it last and whether you can manage it. Returns only what the token owner can see, which the API enforces: a channel you cannot read is refused.

Scope

chat:read

Calls

GET /v1/chat/docs

Example prompt

What docs are in the #launch channel?

Arguments

atlas_chat_docs_restore

Bring an archived chat doc back into its channel doc list. The same people who may archive a doc may restore it. Returns the restored doc.

Scope

chat:write

Calls

POST /v1/chat/docs/{id}/unarchive

Example prompt

Bring back the archived project brief doc.

Arguments

atlas_chat_docs_share

Share a chat doc into another channel or direct message so its members can open it. You need read access to both the doc home channel and the target. Sharing into a channel that already has it is a safe no-op. Returns the share record.

Scope

chat:write

Calls

POST /v1/chat/docs/{id}/share

Example prompt

Share the project brief doc into my DM with Priya.

Arguments

atlas_chat_docs_update

Rename a chat doc, change its icon, or save new content. A content save creates a new revision; pass baseRevision so a save made on stale content is refused rather than overwriting someone else. Returns the doc after the change.

Scope

chat:write

Calls

PATCH /v1/chat/docs/{id}

Example prompt

Add today's decisions to the decision log doc.

Arguments

atlas_chat_ediscovery_export

Produce an encrypted compliance archive of chat messages for legal hold or eDiscovery, for one channel or the whole workspace, optionally bounded by date. Only a workspace owner, an administrator, or a holder of the chat eDiscovery permission may run it, and every run is written to the audit log. Returns the archive storage key, the channel and message counts, its size and its expiry after 24 hours; it does not return message content.

Scope

chat:write

Calls

POST /chat/ediscovery/export

Example prompt

Export the #finance channel for the legal hold covering March.

Arguments

atlas_chat_message_attachments_list

List the files attached to one chat message, in the order they were added. Returns the same fields as the channel attachment list. Returns only what the token owner can see, which the API enforces: a message in a channel you are not a member of is refused.

Scope

chat:read

Calls

GET /v1/chat/messages/attachments

Example prompt

What was attached to Tom's last message?

Arguments

atlas_chat_message_reactions_add

React to a chat message with an emoji as the token owner. Every member of the channel sees the reaction. Adding a reaction you already made is a safe no-op. Returns the message with its reactions after the change.

Scope

chat:write

Calls

POST /chat/channels/{id}/messages/{mid}/reactions

Example prompt

React with a thumbs up to Priya's message.

Arguments

atlas_chat_message_reactions_remove

Remove an emoji reaction the token owner made on a chat message. Reactions made by other people are not affected. Returns the message with its reactions after the change.

Scope

chat:write

Calls

DELETE /chat/channels/{id}/messages/{mid}/reactions

Example prompt

Remove my thumbs up from that message.

Arguments

atlas_chat_messages_delete

Delete a chat message the token owner wrote, or any message when the token owner is a workspace administrator. It disappears for every member of the channel, and no tool or route brings it back. Returns an empty result on success.

Scope

chat:write

Calls

DELETE /v1/chat/channels/{id}/messages/{mid}

Example prompt

Delete the message I just posted in #launch.

Arguments

atlas_chat_messages_list

List a channel message timeline, or the thread under a threadRootId, with cursor pagination and a bounded limit. Use this to catch up on a conversation before replying.

Scope

chat:read

Calls

GET /v1/chat/channels/{id}/messages

Example prompt

Catch me up on the last 20 messages in #general.

Arguments

atlas_chat_messages_pin

Pin a message so every member of the channel sees it in the shared pinned set. Pins are team-shared, not private to you. Pinning an already-pinned message is a safe no-op. Idempotent per MCP call.

Scope

chat:write

Calls

POST /v1/chat/channels/{id}/messages/{mid}/pin

Example prompt

Pin that message in #launch.

Arguments

atlas_chat_messages_search

Full-text search the chat messages you can see, matched against the message body. Omit channelId to search every channel you are in, or pass it to search one channel. Returns the newest matches first, each with its channel name.

Scope

chat:read

Calls

GET /v1/chat/search

Example prompt

Search my chat for the launch checklist.

Arguments

atlas_chat_messages_send

Post a message to a channel, optionally as a threaded reply under threadRootId. Idempotent per MCP call so a retried send does not duplicate the message.

Scope

chat:write

Calls

POST /v1/chat/channels/{id}/messages

Example prompt

Post 'ship it' to the #launch channel.

Arguments

atlas_chat_messages_unpin

Unpin a message from a chat channel, removing it from the pinned set every member sees. Unpinning a message that is not pinned is a safe no-op. Returns an empty result on success.

Scope

chat:write

Calls

DELETE /v1/chat/channels/{id}/messages/{mid}/pin

Example prompt

Unpin the old release checklist in #launch.

Arguments

atlas_chat_messages_update

Edit the text of a chat message the token owner wrote. A message written by someone else is refused. Returns the edited message, marked as edited, and every member sees the new text.

Scope

chat:write

Calls

PATCH /v1/chat/channels/{id}/messages/{mid}

Example prompt

Fix the typo in my last message in #launch.

Arguments

atlas_chat_pins_list

List the pinned messages in a channel, newest first. Every member sees the same shared pin set. You must be a member of the channel to read its pins.

Scope

chat:read

Calls

GET /v1/chat/channels/{id}/pins

Example prompt

Show the pinned messages in #general.

Arguments

atlas_chat_presence_list

List who in the workspace is online in chat right now. Returns the user ids of people with a live chat connection in your own workspace; it never reads another workspace. Use it before starting a conversation that needs a quick answer.

Scope

chat:read

Calls

GET /chat/presence

Example prompt

Who is online in chat right now?

Arguments

This tool takes no arguments.

atlas_chat_saved_messages_add

Save a message to your personal bookmarks. A saved item is private to you: only you ever see or remove it. Saving the same message twice is a safe no-op. Idempotent per MCP call.

Scope

chat:write

Calls

POST /v1/chat/messages/{mid}/save

Example prompt

Save this message for later.

Arguments

atlas_chat_saved_messages_list

List the messages you have saved to your personal bookmarks, newest first. The list is private to you and never includes another user saved items.

Scope

chat:read

Calls

GET /v1/chat/saved

Example prompt

Show me my saved chat messages.

Arguments

This tool takes no arguments.

atlas_chat_saved_messages_remove

Remove a message from the token owner personal saved messages. The message itself is untouched, and removing one that is not saved is a safe no-op. Returns an empty result on success.

Scope

chat:write

Calls

DELETE /v1/chat/messages/{mid}/save

Example prompt

Remove that message from my saved items.

Arguments