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) at https://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:read for the tools that read, synteum:write for 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 confirm only 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_conflict when 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_select sets the default.
- Lists come in pages. synteum_task_list returns 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](https://synteum.com/llms.txt) lists the public pages for language models.
- [llms-full.txt](https://synteum.com/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](https://synteum.com/agents.md) for this page.

Source: https://synteum.com/agents
