---
title: PlumoAI MCP Tools — PlumoAI Developer Guide
description: Every tool the PlumoAI MCP server exposes to AI assistants and agents.
url: https://plumoai.com/developer-page/guides/plumoai-mcp/tools
---

# Supported Tools

Learn what you can do with PlumoAI MCP tools. These tools work seamlessly together through prompts, and their real power comes from combining them.

#### WorkspaceList

Fetch all workspaces (locations) for the authenticated company and user.

**Parameters:** None required

#### ProjectList

Fetch projects. Supports optional filtering by projectId or workspaceId. If workspaceId=-1, returns all projects (useful for searching by name). Note: Also fetch sprints for Scrum projects after getting specific project.

**Parameters:** projectId (optional, number), workspaceId (optional, number, -1 for all)

#### ProjectTablesList

Fetch all tables for a given project.

**Parameters:** projectId (required, number)

#### ProjectCategories

Fetch state categories for a specific project by project ID.

**Parameters:** projectId (required, number)

#### ProjectSprints

Fetch all sprints for a specific project by project ID. Note: if project is not scrum template project then it will return empty array.

**Parameters:** projectId (required, number)

#### RecordList

Fetch list of records with including all custom field values of record. Supports filters (project, sprint, table etc.). Note: Required Sprint ID for scrum project. Pass 0 For non Scrum projects, and For scrum project must be pass sprint ID by fetching all sprints and pass current sprint id after identifying from sprint list.

**Parameters:** projectId (required, number), sprintId (required, number), workitemTypeId (number, default -1)

#### DetailedRecord

Fetch full details of a record (task). Includes: basic record fields, users (created by, modified by, assignee), comments, attachments, linked tasks, and checklist items.

**Parameters:** recordId (required, number)

#### CreateRecord

Create a new record inside a project. Requires projectId, workflowId, statusId and table ID. Supports assignees and optional sprint/parent task linking.

**Parameters:** projectId, title, statusId, tableId (required), description, parentTaskId, sprintId, priority, assignedUsers (optional)

#### UpdateRecordField

Update a single field value in a record. Requires recordId and fieldId. Supports text, users, teams, and JSON fields.

**Parameters:** recordId, fieldId (required), value, requiresQuotes, text, users, teams, userType, jsonValue, uniqueField (optional)

#### ChangeRecordStatus

Change record status in a record. Requires recordId and statusId.

**Parameters:** recordId, statusId (required)

#### TableFieldsTab

Fetch field tabs (sections of fields) for a given table (workitem type).

**Parameters:** tableId (required, number)

#### CustomTableFields

Fetch custom fields for a given table (workitem type) within a project. Fetch all and ask all required fields before create new in table.

**Parameters:** projectId, tableId (required, number)

#### ProjectTableStatusList

Fetch all table records status list for a given project and optional table id.

**Parameters:** projectId (required, string), tableId (optional, string, default "-1")

#### AddRecordComment

Add comment in a record. Requires recordId and comment.

**Parameters:** recordId, comment (required, string, HTML format)

#### Document\_List

Fetch list of documents. Use ProjectList if projectId is unknown.

**Parameters:** projectId (required, number), webDocumentId (optional, number, 0 for all)

#### Document\_Detail

Fetch document detail. Use ProjectList if projectId is unknown.

**Parameters:** projectId, webDocumentId (required, number)

#### Implement-Project

Create or Implement a Project.

**Parameters:** projectId (required, number)

### Rate Limits

Standard API request limits apply per user's usage of PlumoAI MCP (totaled across all tool calls).

Currently, this is an average of **180 requests per minute** (3 requests per second).

Some MCP tools have additional, tool-specific rate limits that are stricter:

- **Search:** 30 requests per minute

**Note:** In most cases, the time it takes to do a complex AI-powered search across PlumoAI and your connected tools means that sequential searches will typically stay under the rate limit. If you encounter rate limit errors, prompt your LLM tool to reduce the amount of parallel searches or operations performed using PlumoAI MCP, and/or try again later.