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:
EVTfor meetings,CNTfor contacts,CMPfor companies. - A task that was moved to another project still answers to its old reference.
- The tool
resolve_refreturns 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_workspaceorsearch_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
Zmeans an exact instant:2026-11-20T15:00:00+03:00. - In range filters (
fromandto,dateFromanddateTo) 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 intools/listsays thatnoneclears 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 |
Search
| 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 returns403with the codemcp_forbidden. - Parts of the product switched off in a workspace. If tasks, the knowledge base or CRM is off, its tools return
403with the codemodule_disabled. - Files on the person’s computer. The server does not read file paths; content is passed in the
filesparameter. - 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.