Connect your AI assistant to Superthread

Ask a question about your Superthread workspace and get a RAG-backed answer drawn from cards, pages, comments, and notes.

• Searches across your accessible workspace content to find relevant information.
• Only answers questions about information explicitly documented in your workspace.
• Cannot answer about work status or timelines unless that information exists in your content.
• Synthesizes an answer (RAG) rather than returning a list of resources.
• Questions must be at least 10 characters; longer, more specific questions yield better answers.

Find pages (docs) by structured filters: space, creator, page IDs, full-text content, and created/updated date ranges, with exclude_ mirrors and sorting. Paginated — if next_cursor is non-empty, pass it back as cursor to fetch the next page. For 'how many?' questions use the 'total' field on the first page rather than counting the pages array. Results are compact (no page body) — follow up with page_get for a page's content. Refs to space/user take names or IDs — pass user wording directly, don't list/get/search to resolve first. For full-text search across resource kinds (tasks, comments, notes, pages), use the 'search' op instead.

Find tasks. Pass query for full-text search, or structured filters (assignees, tags, priority, due dates, has_*, etc.) for filtered listings. In query mode results are sparse (id + title only) since search hits don't carry full task data — follow up with task_get for detail. Filter mode is paginated — if next_cursor is non-empty, pass it back as cursor to fetch the next page. For 'how many?' questions use the 'total' field on the first page (the authoritative full match count) rather than counting the tasks array — the array is just one page. Combining query with filters is not yet supported — the handler returns a structured validation error explaining how to split-and-intersect when both are passed. Refs to space/board/sprint/list/project/user/tag take names or IDs — pass user wording directly, don't list/get/search to resolve first. For any user filter, pass 'me' for the caller rather than their email or display name. Block relationships are RELATIONSHIPS between tasks, not tags or statuses — use has_blockers / has_blocking for 'what's blocked / blocking?'; relationship_types only for related, duplicates, or OR-combinations across types.

Cross-resource full-text search. Use types to scope to particular resource kinds; for tasks specifically, find_tasks supports richer filters.

Search the Superthread MCP server's operation catalog by natural-language query. Returns matching op names, descriptions, and input schemas. Use this when you don't see a tool in the initial list that matches what you need to do, or to discover the right tool for a multi-step workflow without scanning the full catalog.

Link one task to another. The reciprocal is created automatically — linking A→B as 'blocks' marks B 'blocked_by' A — so call once per pair; a reversed second call is rejected as a contradictory loop.

Add tags to a task. Idempotent — tags already on the task are silently skipped (no 400). Use tags_list with space_id to discover applicable tags.

Archive a task (reversible, hides from normal listings).

Create a task on a regular board. At least one of list_id, board_id, or sprint_id is required. list_id name resolution priority: board_id (if set) → sprint_id+space_id (if set). Defaults when list_id is omitted: first column of board_id on a board create, sprint's default list on a sprint create. Refs to space/board/sprint/list/project/user/tag take names or IDs — pass user wording directly, don't list/get/search to resolve first.

Permanently delete a task. Prefer task_archive for reversible removal.

Create a copy of a task in the same list.

Get one task by ID with full detail (tags, parent/children, content, links).

List tasks in a known container — requires at least one of board_id, sprint_id, assignee_id, or archived=true. list_id names resolve against board_id, else sprint_id+space_id. Names or IDs accepted; don't pre-resolve.

Remove a link between two tasks.

Remove tags from a task.

Update a task. Omit fields to leave them unchanged. Status follows the task's list — move it to a different list to change status. list_id names resolve against board_id, else sprint_id+space_id, else the task's current board/sprint (so list_id='Done' alone moves it in place); omitted, it defaults to the board's first column or the sprint's Todo. Names or IDs accepted; don't pre-resolve.

Create a board in a space.

Create a list (column) on a board. Behavior controls the status tasks get when in this column.

Permanently delete a board and its tasks. Irreversible.

Create a copy of a board (including its column layout) in the same space.

Get one board with its column (list) layout.

List boards in a space. Returns the lean shape (no list/column layout); call board_get for full detail.

Update a board. Omit fields to leave them unchanged.

Update a list. Omit fields to leave them unchanged.

Create a sprint in a space.

Get one sprint with its column (list) layout.

List sprints in a space.

Get a space's sprint settings (cadence, length, start day).

Replace a space's sprint settings (PUT-style — all four fields are written every call). Fetch current settings first via sprint_settings_get if you only want to change one field.

Update a sprint. Omit fields to leave them unchanged.

Link one project to another. The reciprocal is created automatically — linking A→B as 'blocks' marks B 'blocked_by' A — so call once per pair; a reversed second call is rejected as a contradictory loop.

Add workspace-level tags to a project. Idempotent — tags already on the project are silently skipped. Project tagging only accepts workspace-level tags (call tags_list with no space_id to discover them).

Add a task to a project. Project↔task is membership (a project contains tasks), distinct from project↔project relationships (project_add_related).

Archive a project (reversible).

Create a project (epic) on the workspace's project board. If list_id is omitted, defaults to the first column of the project board. Refs to list/user/tag take names or IDs — pass user wording directly, don't list/get/search to resolve first.

Permanently delete a project. Prefer project_archive for reversible removal.

Get one project with full detail (tags, assignees, archive metadata, health).

Delete a single health-update entry from a project's history.

List the project's health-update history (status transitions with messages).

Set the cadence (in days) at which the project owner is reminded to post a health update.

Post a new health update on a project. Server validates the status enum.

List all projects (epics) visible to the caller.

Remove a relationship between two projects.

Remove tags from a project.

Remove a task from a project (membership only — the task itself is not deleted).

Update a project. Omit fields to leave them unchanged. add_assignee_ids adds to existing assignees and is idempotent (already-assigned users are silently skipped); set_assignee_ids REPLACES the set (pass [] to clear). Add/Set are mutually exclusive. project_id and refs to list/user take names or IDs — pass user wording directly, don't list/get/search to resolve first.

Add a user as a member of a space.

Create a space.

Permanently delete a space and all its contents. Irreversible.

Get one space with full detail (members, archived metadata).

List all spaces visible to the caller. Returns the lean shape (no member listing); use space_get for full detail.

Remove one or more users from a space.

Update a space. Omit fields to leave them unchanged.

Archive a page (reversible).

Create a page in a space. Pass parent_page_id to nest it under another page.

Permanently delete a page. Prefer page_archive for reversible removal.

Create a copy of a page in the same space.

Get one page with full detail (cover, collaboration token, archive metadata, watching state).

List a space's pages. Results are compact (no body); use page_get for a page's content, or find_pages for filtered or cross-space discovery (by creator, content, or date).

Update a page. Omit fields to leave them unchanged. Content replaces the page body entirely. Set parent_page_id to move the page under a different parent.

Create a comment or reply. Pass exactly one of task_id, page_id, or parent_comment_id.

Delete a comment. Pass parent_comment_id to delete a reply.

Edit a comment. Pass parent_comment_id to edit a reply.

Get one comment. Pass parent_comment_id to fetch a reply.

List comments. Pass exactly one of task_id (comments on a task), page_id (comments on a page), or parent_comment_id (replies to a comment).

Add an emoji reaction to a comment.

Remove a reaction from a comment.

Add an item to a checklist.

Create a checklist on a task. Add items via checklist_add_item.

Delete a checklist (and all its items) from a task.

Delete a single item from a checklist.

Get one checklist with its items.

List checklists on a task.

Update a checklist. Omit fields to leave them unchanged.

Update a checklist item. Pass checked=true/false to mark/unmark; pass title/content to edit. Omit fields to leave them unchanged.

Create a note. Notes are usually titled at creation; transcript/AI summary/user notes are populated through the meeting lifecycle.

Permanently delete a note.

Get one note with its meeting context, transcript, AI summary, and user notes inline.

List notes (personal notes / meeting transcripts) visible to the caller. Paginated — if next_cursor is non-empty, pass it back as cursor to fetch the next page.

Remove a member from the workspace.

List all members of the current workspace.

Get the calling user's workspace member profile (id, role, status, names, email).

Update another workspace member (typically: change their role). Omit role to leave it unchanged.

Update the calling user's profile fields. Omit fields to leave them unchanged.

Get the current workspace's metadata. The archived/trashed fields appear only when the workspace is in that state — absent means active, not unknown.

List tags. With space_id: returns workspace + that space's tags (use for task tagging). Without space_id: returns only workspace-level tags (use for project tagging — projects cannot carry space-level tags).