SectionTools for your AI

Tools for your AI

Which actions a connected AI app can take in Syncra, group by group, and the rules every tool follows for references, dates, deletion and paging.

A tool is one action a connected AI app performs in Syncra: read a channel, send a message, create a task, find a page. The app calls tools over MCP (Model Context Protocol), an open standard that AI apps use to work with outside services. The Syncra server offers 193 tools today. Every call runs as the person who connected the app, with that person’s rights. Any workspace member who connected an app with the guide Connect your AI can use the tools. Tools that manage bots, members and workspace settings work only for an owner or an admin.

How to call a tool

A ready-made MCP client such as Claude or Cursor makes these calls on its own. If you write the client yourself, every call goes to one address.

POST /api/mcp

Takes one request in JSON-RPC 2.0: the list of tools, or a tool call.

Parameter Type Required Description
jsonrpc string yes Always "2.0"
id number or string yes Your request number, returned in the answer
method string yes tools/list returns the list of tools, tools/call calls a tool
params.name string for tools/call The tool name, for example list_tasks
params.arguments object for tools/call The tool’s parameters. Their description comes in the tools/list answer

Headers: Authorization: Bearer syncat_..., Content-Type: application/json and Accept: application/json, text/event-stream.

curl -X POST "https://ai-syncra.ru/api/mcp" \
  -H "Authorization: Bearer syncat_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_tasks","arguments":{"projectId":"<project id>","limit":50,"offset":0}}}'

Response 200:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "..." }
    ]
  }
}

The text field holds Syncra’s answer as a JSON string. Parse it once more.

If the tool failed, the status is still 200, and the result carries the isError flag and the error text:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      { "type": "text", "text": "Error: HTTP 403: This module is turned off in this workspace (GET /api/wiki/pages/<id>)" }
    ],
    "isError": true
  }
}

In this example the knowledge base is switched off in the workspace. When Syncra refuses an action, the text is built like this: the word Error:, the HTTP status, the message, and in brackets the request that did not pass.

tools/list always returns the current list of tools and their parameters. The tables below explain what each group of tools does.

Shared rules

References to objects

A tool takes either an internal id or a short reference of the form KEY-number, for example SYN-298. In Syncra a person sees this reference on a task.

  • Tasks, epics, knowledge base pages, meetings, deals, contacts and companies have short references.
  • Three keys are reserved across the whole workspace: EVT for meetings, CNT for contacts, CMP for companies.
  • A task that was moved to another project still answers to its old reference.
  • The tool resolve_ref returns the object for a reference or an id.
  • A workspace is named by the parameter workspaceSlug: the short name of the workspace from its address.
  • A tool cannot pick an object by its title. Search first, for example with search_workspace or search_tasks, then act on the id or reference from the answer.

Dates and time

Tools read dates in the time zone of the person the app works for.

  • A date without a time, 2026-11-20, is midnight of that day on the person’s clock.
  • A date and time without an offset, 2026-11-20T15:00, is 15:00 on the person’s clock.
  • Only an explicit offset or Z means an exact instant: 2026-11-20T15:00:00+03:00.
  • In range filters (from and to, dateFrom and dateTo) a date without a time at the end of the range includes that whole day.

An empty value erases nothing

Syncra treats an empty string or spaces in an optional text field as if the field was not sent. AI models often put an empty string into fields they did not mean to change, and this rule keeps that from erasing data.

  • To leave a field as it is, do not send it.
  • To clear a field, send the word none. clear, нет, очисти and очистить work too. This works for these fields only: a task’s description, dates, epic and assignee; an epic’s description, status note, dates and assignees; a deal’s amount, expected close date, owner and company; a meeting’s description. The description of such a field in tools/list says that none clears it.

Deletion with confirmation

Eight tools delete data and take a required parameter confirmed: delete_workspace, delete_project, delete_epic, delete_task, delete_label, delete_wiki_page, destroy_wiki_page and delete_bot.

With confirmed: false nothing is deleted. The tool returns an object with the field "needsConfirmation": true and a description of what would be deleted. The app has to ask the person and call the tool again with confirmed: true.

Paging

Tools that return lists use one of three paging schemes.

Scheme How to page Tools
Offset and page size offset and limit. The answer carries the total number of records, or a flag that more records remain list_tasks (up to 500 per page), list_bookmarks (up to 200), list_deals, list_contacts, list_companies (up to 100, default 50), list_meeting_notes (up to 100, default 20), get_meeting_transcript (up to 500, default 100), list_wiki_page_comments (up to 200, default 50), list_wiki_favorites, list_wiki_recents, list_wiki_shared (up to 200), get_transcript (segmentLimit up to 2000 and segmentOffset)
Cursor limit and the marker of the last record from the previous page get_channel_messages (cursor), get_thread_replies (after), get_user_activity, get_task_activity, get_workspace_activity (before)
No pages They return everything at once, or the first results search_tasks (up to 100, default 20), search_workspace, list_wiki_pages, list_projects, list_channels and other short lists

Files

send_message and create_task_comment take a files parameter: up to 10 files, each an object with the fields name (1 to 255 characters), content (up to 5,000,000 characters) and encoding (utf8 or base64).

You cannot pass a path to a file on your computer, because the server does not run on your machine. For the same reason the tool upload_task_attachment and the parameter attachmentPaths do not work through the server address https://ai-syncra.ru/api/mcp.

Text length

Field Limit
Message text 4000 characters
Task title 300 characters
Task description 10,000 characters
Knowledge base page title 300 characters

Tool groups

Account and profile

Tool What it does
get_current_user The profile of the person the app works for
get_current_auth_user The same under another name: who is connected now
update_current_user Changes the name, description and avatar in the person’s own profile
get_user_profile Another member’s profile: name, email, time zone, description
get_user Brief details of a member by id
get_user_activity What a member did in the workspace: task events, comments, page edits. Newest first

The list also has four service tools for the sign-in page: get_auth_config, forgot_password, reset_password and resend_verification_email. A connected app has no need for them.

Workspaces and members

Tool What it does
list_workspaces The workspaces the person belongs to
create_workspace Creates a workspace with a #general channel
get_workspace A workspace by workspaceSlug, with the person’s role in it
update_workspace Changes the name, address, language or icon. Owner and admin only
delete_workspace Deletes the whole workspace. Owner only, needs confirmed
list_workspace_members Members with their roles, status and online state
add_workspace_member Adds a person with a chosen role. Owner and admin only
update_workspace_member Changes a member’s role or team. Owner and admin only
remove_workspace_member Removes a member. Owner and admin only
leave_workspace Leaves the workspace. The only owner cannot leave
set_workspace_status Sets the person’s status: emoji, text, expiry, pausing notifications
clear_workspace_status Clears the person’s status
get_workspace_presence Which members are online now
send_presence_heartbeat Refreshes the person’s own online status
get_workspace_member_count The number of members
get_workspace_unread_counts Unread messages and mentions per channel
get_workspace_activity The person’s own feed: mentions, reactions, notifications

Channels and direct messages

Tool What it does
list_channels The channels the person is in
browse_channels Public channels of the workspace, to look through and join
create_channel Creates a public or private channel
update_channel Changes the name, description and topic, archives the channel, switches it between public and private
list_channel_members The members of a channel
join_channel Joins a public channel, or adds another member to a channel
leave_channel Leaves a channel. A one-to-one chat cannot be left
remove_channel_member Removes a member from a channel. Needs channel admin or workspace admin rights
update_channel_member Makes a member a channel admin, or removes that role
list_dms Direct and group chats, most recent first
open_dm Opens a direct chat with a member, or finds the existing one
create_group_dm Creates a group chat: the person and 2 to 7 other members

Messages

Tool What it does
get_channel_messages Messages of a channel, page by page
get_message One message by id
send_message Sends a message to a channel or a reply in a thread, with mentions and files
edit_message Edits the text of the person’s own message
delete_message Deletes a message. The author or a workspace admin can do it
forward_message Forwards a message to another channel with a comment
add_reaction Adds an emoji reaction
remove_reaction Removes the person’s own reaction
pin_message Pins a message in its channel. Needs channel admin or workspace admin rights
unpin_message Unpins a message
get_pinned_messages The pinned messages of a channel
bookmark_message Saves a message to the person’s saved items
unbookmark_message Removes a message from saved items
list_bookmarks The person’s saved messages
mark_channel_read Marks a channel read up to a message the person was shown
mark_mention_read Marks the person’s mention in a message as read
send_typing_indicator Shows or hides the “typing” sign in a channel
complete_message_action Runs an action suggested under a message: create a task, save to the knowledge base, remember, or record a decision
dismiss_message_action Hides a suggested action for everyone

Sending a message marks nothing as read. What the person has not seen stays unread until they see it themselves.

Threads

Tool What it does
get_thread_replies Replies in a thread, page by page
post_thread_reply Replies in a thread. The reply can also be shown in the channel
get_thread_summary Thread details: number of replies, time of the last one, participants
subscribe_thread Subscribes the person to a thread
unsubscribe_thread Unsubscribes the person from a thread

Thread tools take the message that started the thread as rootId or threadRootId. Send one of the two.

Projects and columns

Tool What it does
list_projects The projects of a workspace
get_project A project with its columns and its knowledge base space
create_project Creates a project with default columns and its own knowledge base space
update_project Changes the name, description, color, icon, default view and instructions for the AI. Archives the project
delete_project Deletes a project. The project’s creator or an admin can do it, needs confirmed
create_project_section Adds a column at the end
update_project_section Renames a column or moves it
delete_project_section Deletes a column. Its tasks stay, without a column
list_project_members Who is excluded from the project
toggle_project_member_exclusion Excludes a member from a project or brings them back. Owner and admin only

Epics

Tool What it does
list_epics The epics of a project, with progress for each
create_epic Creates an epic: name, description, color, assignees, dates
update_epic Changes the fields of an epic
delete_epic Deletes an epic. Its tasks stay. Needs confirmed

Tasks

Tool What it does
list_tasks The tasks of a project, page by page
get_task A whole task: subtasks, labels, followers
get_my_tasks The person’s tasks grouped by due date: overdue, today, upcoming, no date, done
search_tasks Search over task titles and descriptions
resolve_ref Finds an object by a short reference or an id
create_task Creates a task: a title is enough, the other fields are optional
update_task Changes the title, description, priority, dates, epic and assignee
complete_task Marks a task done, or reopens it
move_task Moves a task to another column, or changes its place in the column
delete_task Deletes a task. The creator, the assignee or an admin can do it, needs confirmed
restore_task Restores a deleted task
follow_task Subscribes the person to changes of a task
unfollow_task Unsubscribes the person from changes of a task
link_subtask Makes an existing task a subtask of another
unlink_subtask Detaches a subtask, which becomes a standalone task again
get_task_source Where a task came from: a chat message or the notes of a call
get_task_activity The history of a task: who changed what, and when
list_task_revisions Earlier versions of the title, description, priority and due date
restore_task_revision Returns a task to a chosen version

Task comments, attachments and labels

Tool What it does
list_task_comments The comments on a task, in order
create_task_comment Writes a comment, with mentions and files
update_task_comment Edits the person’s own comment
delete_task_comment Deletes the person’s own comment
list_task_attachments The attachments of a task
add_task_attachment Attaches an already uploaded file to a task
upload_task_attachment Uploads a file by a path on a computer. Does not work through the server address
delete_task_attachment Removes an attachment
list_labels The labels of a workspace
create_label Creates a label. If a label with that name exists, returns it
delete_label Deletes a label and takes it off every task. Needs confirmed
add_task_label Puts a label on a task
remove_task_label Takes a label off a task

Knowledge base

Tool names call the knowledge base wiki. Pages live in spaces: a space is the container that holds the pages of one project.

Tool What it does
list_wiki_spaces The knowledge base spaces of a workspace
get_wiki_space One space
update_wiki_space Changes the name, description and icon of a space
get_wiki_space_tree The page tree of a space, with nesting levels
list_wiki_pages The pages of a space: titles and metadata only, no text
get_wiki_page A page with its text. With metadataOnly, without the text
create_wiki_page Creates a page, optionally from a template
update_wiki_page Changes the text and properties of a page. expectedRevision guards against writing over someone else’s edit
move_wiki_page Moves a page with its child pages: under another page, to another position, or to another space
duplicate_wiki_page Makes a copy of a page next to it
delete_wiki_page Sends a page to the trash, from where it can be restored. Needs confirmed
list_wiki_trash The pages in a space’s trash
restore_wiki_page Brings a page back from the trash
destroy_wiki_page Deletes a page for good, with its child pages and their versions. Needs confirmed
export_wiki_page Exports a page as Markdown
list_wiki_page_comments The discussions on a page, page by page
list_wiki_page_revisions The list of a page’s versions, without text
get_wiki_page_revision One version of a page, with its text
restore_wiki_page_revision Returns a page to a chosen version
get_wiki_page_backlinks The pages that link to this one
favorite_wiki_page Adds a page to the person’s favorites
unfavorite_wiki_page Removes a page from favorites
list_wiki_favorites The person’s favorite pages
list_wiki_recents The pages the person opened recently
list_wiki_shared The pages published by a public link
list_wiki_templates Page templates
save_wiki_page_as_template Saves a page as a template

Calendar meetings

Tool What it does
list_meetings Meetings in a period, with filters by attendee and channel
get_meeting A meeting with its attendees and their answers to the invitation
create_meeting Schedules a meeting: title, start, end, channel, attendees
update_meeting Changes the title, description, time and attendees
cancel_meeting Cancels a meeting. The organizer or an admin can do it

For a repeating meeting the parameter scope says what to change: single for this one only, following for this one and the later ones, series for the whole series.

Recorded meetings (Syncra Notes)

In Syncra Notes, a meeting that was recorded or uploaded gets a transcript and notes.

Tool What it does
list_meeting_notes The recorded meetings the person may read. Has search and a date filter
get_meeting_notes The notes of one meeting: summary, decisions, action items with owners and due dates
get_meeting_transcript The transcript of a meeting, page by page

These tools take the id from the list_meeting_notes answer. A short reference such as EVT-12 belongs to a calendar meeting and does not fit here.

CRM

Tool What it does
list_deals The deals on a project’s board, with filters by status, stage, owner and company
get_deal A deal with its contacts, linked meetings and the reason it was lost
create_deal Creates a deal and returns its short reference
update_deal Changes the title, amount, expected close date, owner and company
move_deal_stage Moves an open deal to another stage
close_deal Closes a deal as won or lost
reopen_deal Puts a closed deal back on the board
list_lost_reasons The dictionary of lost reasons
list_contacts Contacts: people
create_contact Creates a contact
list_companies Companies
create_company Creates a company
Tool What it does
search_workspace Searches messages, knowledge base pages, tasks, comments, people and calls. Has filters by type, channel, author and dates
search_wiki_space Searches the pages of one knowledge base space
prioritize_inbox Ranks the items of the person’s feed by urgency with AI: high, normal, low

Bots

Only a workspace owner or admin can manage bots. Any member can see the list of bots and the list of slash commands. The page Bots explains what a bot is.

Tool What it does
list_bots The bots of a workspace, without secrets
get_bot A whole bot: its system prompt and the channels it is in
create_bot Creates a bot
update_bot Changes a bot’s profile and settings, switches it on and off
delete_bot Deletes a bot with all its keys, webhooks, subscriptions and commands. Needs confirmed
list_bot_tokens A bot’s keys, revoked ones included
create_bot_token Creates a bot key. The full value comes once
revoke_bot_token Revokes a key
list_bot_webhooks A bot’s incoming webhooks
create_bot_webhook Creates an incoming webhook for a channel. The bot joins that channel on its own
delete_bot_webhook Deletes an incoming webhook
list_bot_subscriptions A bot’s event subscriptions, with signing secrets
create_bot_subscription Creates a subscription: an address and a list of events
update_bot_subscription Changes the address and events of a subscription, switches it on and off
delete_bot_subscription Deletes a subscription and its delivery log
test_bot_subscription Sends a signed test event to the subscription’s address
list_bot_deliveries Recent event deliveries
list_bot_task_runs The 20 latest runs of the task runner
list_bot_commands A bot’s slash commands, with signing secrets
create_bot_command Registers a slash command
update_bot_command Changes the name, description and address of a command, switches it on and off
delete_bot_command Deletes a slash command
list_workspace_commands All enabled slash commands of a workspace
invoke_slash_command Runs a slash command in a channel the person is in

Calls and transcripts

Tool What it does
get_call_status Whether a call is running in a channel, and who is in it
get_incoming_call The incoming call for the person, if there is one
start_call Creates the card of a started call in a channel
end_call Marks a call ended if no people are left in it. After that the notes are prepared
ring_call Rings the other people in a direct or group chat
invite_to_call Calls members into a running call
cancel_call Cancels the person’s call before it is answered
decline_call Declines an incoming call
get_call_token Issues a key for joining the call room
get_transcript The transcript of a call by id, page by page

What is closed to a connected app

  • Syncra addresses that require sign-in and start with /auth/, /api/auth/ (account sign-in), /api/oauth/ (granting access to apps) or /api/_internal/ (the Syncra team’s service console). A request to them returns 403 with the code mcp_forbidden.
  • Parts of the product switched off in a workspace. If tasks, the knowledge base or CRM is off, its tools return 403 with the code module_disabled.
  • Files on the person’s computer. The server does not read file paths; content is passed in the files parameter.
  • Everything the person cannot see: private channels they are not in, and other people’s direct chats.

A refusal comes as a tool error in the same form as in the example above: the isError flag and a text with the HTTP status.