Resources · Agents
Connect an AI agent.
Synteum has a remote MCP server for AI clients and a REST API for programs. An agent works with your account, sees only what you can see, and shows a preview before it deletes anything.
Connect an MCP client
Add the remote server https://mcp.synteum.com to an MCP client that supports OAuth 2.1 and dynamic client registration. The client opens the Synteum sign-in. You sign in with your Synteum email and password, plus MFA when it is on, and the client receives a token.
- Endpoint:
https://mcp.synteum.com - Transport: Streamable HTTP, stateless, with JSON responses.
- Health check:
https://mcp.synteum.com/healthz
Sign-in and access
- Discovery: protected resource metadata (RFC 9728) at
https://mcp.synteum.com/.well-known/oauth-protected-resource, and authorization server metadata (RFC 8414) athttps://mcp.synteum.com/.well-known/oauth-authorization-server. - Registration: dynamic client registration (RFC 7591) at
https://mcp.synteum.com/oauth/register. Redirect URIs use https, or http on a loopback address. - Flow: authorization code with PKCE S256. The authorization request names the resource
https://mcp.synteum.com. - Scopes:
synteum:readfor the tools that read,synteum:writefor the tools that change data. Write includes read. A client that asks for no scope receives both. - Tokens: an access token lives 15 minutes, and a refresh token rotates on every use. The grant ends with your Synteum session (at most 7 days idle and 30 days in total), when you sign out, or when you revoke it.
- Access: the agent acts as you. It sees the same workspaces, holds the same role in each, and reaches the same projects and boards. The server adds no rights of its own.
Rules an agent works by
- A destructive tool changes nothing on its first call. It returns a preview, and the agent calls it again with
confirmonly after you agree. Deleting a task also needs the version shown in the preview. - Every write carries a fresh idempotency key, so a retry never creates a duplicate. An update or a move answers
version_conflictwhen someone else changed the item in the meantime. - Tools take an optional workspace. Without it, the server uses your only workspace or your default one.
synteum_workspace_selectsets the default. - Lists come in pages.
synteum_task_listreturns 1 to 50 tasks per page, 20 by default, with a cursor for the next page. - The server limits the calls of each user and answers 429 with Retry-After when an agent sends too many.
- Files are uploaded in the app. The MCP server has no upload tool.
Tools
The server offers 99 tools. Every name starts with synteum_, which the lists below leave out. Each tool states whether it reads or changes data, and carries an input and an output schema.
Account and workspaces
whoami, workspace_list, workspace_select
Tasks
task_list, task_search, task_get, task_create, task_create_many, task_update, task_move, task_archive, task_restore, task_delete
Comments, checklists and links
comment_add, comment_list, comment_update, comment_delete, checklist_list, checklist_add, checklist_update, checklist_move, checklist_delete, link_list, link_add, link_remove
Attachments
attachment_list, attachment_read, attachment_rename, attachment_delete
Time and Timeframes
time_log, time_list, time_update, time_delete, time_report, timeframe_list, timeframe_create, timeframe_update, timeframe_delete
Tags
tag_list, tag_create, tag_update, tag_delete
Projects, boards and columns
project_list, project_get, project_create, project_update, project_archive, project_restore, project_move, project_delete, board_list, board_get, board_create, board_update, board_move, board_delete, column_create, column_update, column_move, column_delete, board_export, board_import, board_clear
Teams, members and access
team_list, team_get, team_create, team_update, team_delete, team_restore, team_transfer, team_leave, team_settings_get, team_settings_update, team_member_list, team_member_add, team_member_update, team_member_remove, member_access_get, member_access_set
Invitations and join codes
invitation_list, invitation_accept, invitation_decline, team_invitation_list, team_invitation_get, team_invitation_resend, team_invitation_revoke, join_code_create, join_code_list, join_code_revoke, join_code_redeem
Activity, alerts and notifications
activity_list, alert_list, alert_dismiss, portfolio_get, notification_list, notification_read, notification_read_all
Task style
convention_get, convention_set
REST API
Programs use the REST API under https://synteum.com/v1. A program acts with the role of the account it signs in with, and sees only the projects and boards that account can see.
Machine-readable pages
- llms.txt lists the public pages for language models.
- llms-full.txt holds the text of every public page in one Markdown file.
- Each public page has a Markdown version, for example agents.md for this page.