MCP

Svit.One provides a remote Model Context Protocol (MCP) server. Compatible AI assistants and applications can use it to list your projects, work with tasks and opportunities, and read or create comments.

Connect an MCP client

Add the following remote MCP server URL to your client:

https://api-external.svit.one/mcp

Select Streamable HTTP as the transport if your client asks for one. Configuration field names vary by client, but a typical remote-server entry looks like this:

{
    "mcpServers": {
        "svit": {
            "url": "https://api-external.svit.one/mcp"
        }
    }
}

When prompted, sign in to Svit.One and approve access. The client can access only projects you belong to.

How to use the tools

Start with list_projects, then use its projectId with the other tools. Useful discovery flows include:

• Call list_folders before filtering tasks by folder or creating or updating a task in a folder.
• Call list_project_users before filtering tasks by assignee or assigning a task.
• Call list_tasks before reading or creating comments on a task.

Project tools

list_projects

Lists every Svit.One project the authenticated user belongs to.

Inputs: None.

Output: A projects array whose entries contain:

list_tasks

Lists tasks in a project, with pagination, search, filtering, and sorting.

Output: A tasks array of task objects and a pagination object containing total, page, limit, and totalPages numbers.

create_task

Creates a task in a project.

Output: The created task object.

update_task

Updates an existing task. Only provided fields change. Pass null to clear a nullable field or an empty assigneeIds array to remove all assignees. At least one field to update is required. The connected user needs tasks:edit access in the project.

Output: The updated task object.

list_folders

Lists task folders in a project.

Output: A folders array whose entries contain:

list_project_users

Lists the active members of a project.

Output: A users array of user objects.

Opportunity tools

read_opportunity

Reads an opportunity by ID. The authenticated user must have access to both CRM opportunities and the opportunity's pipeline.

Output: An opportunity object.

create_opportunity

Creates an opportunity in a project's default pipeline and initial stage.

Output: The created opportunity object.

Comment tools

Comments are polymorphic: they can be attached to different kinds of Svit.One objects. For task comments, use task as the objectType and a task ID as the objectId.

Supported objectType values are dataset, site, project, task, and conversation.

list_comments

Lists comments attached to an object in a project.

Output: A comments array of comment objects.

create_comment

Adds a comment to an object in a project.

Output: The created comment object.

Shared result objects

Opportunity object

Task object

User object

Comment object

Task values

Task statuses are todo, in-progress, review, and done.

Task priorities are high, medium, low, and none.