Plaky MCP by usefulapi is an MCP server published by io.usefulapi, hosted at plaky.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 20 tools, including plaky_get_current_user, plaky_list_users, plaky_list_teams, plaky_get_team, plaky_list_spaces.
Read boards and items, create items, set field values and add comments in Plaky.
4,071 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Return the owner of the API key: id, name, email, role (OWNER/ADMIN/MEMBER/VIEWER) and status. Good first call to verify the key works. Plaky API: GET /v1/public/users/me.
No parameters.
{
"name": "plaky_get_current_user",
"title": "Get current user",
"description": "Return the owner of the API key: id, name, email, role (OWNER/ADMIN/MEMBER/VIEWER) and status. Good first call to verify the key works. Plaky API: GET /v1/public/users/me.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get current user",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
List workspace users, optionally filtered by email, status (ACTIVE/PENDING/INACTIVE) or role (OWNER/ADMIN/MEMBER/VIEWER). Plaky API: GET /v1/public/users.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-indexed (default 1). |
| type | string | Only users with this role. |
| emails | array | Only users with these email addresses. |
| status | string | Only users in this status. |
| page_size | integer | Results per page (default 50). |
{
"name": "plaky_list_users",
"title": "List users",
"description": "List workspace users, optionally filtered by email, status (ACTIVE/PENDING/INACTIVE) or role (OWNER/ADMIN/MEMBER/VIEWER). Plaky API: GET /v1/public/users.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number, 1-indexed (default 1).",
"exclusiveMinimum": 0
},
"type": {
"enum": [
"OWNER",
"ADMIN",
"MEMBER",
"VIEWER"
],
"type": "string",
"description": "Only users with this role."
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only users with these email addresses."
},
"status": {
"enum": [
"ACTIVE",
"PENDING",
"INACTIVE"
],
"type": "string",
"description": "Only users in this status."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Results per page (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true
}
}List workspace teams. Use the team ids when you subscribe teams to items. Plaky API: GET /v1/public/teams.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-indexed (default 1). |
| page_size | integer | Results per page (default 50). |
{
"name": "plaky_list_teams",
"title": "List teams",
"description": "List workspace teams. Use the team ids when you subscribe teams to items. Plaky API: GET /v1/public/teams.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number, 1-indexed (default 1).",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Results per page (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List teams",
"readOnlyHint": true
}
}Get one team by id, with its members. Plaky API: GET /v1/public/teams/{teamId}.
| Parameter | Type | Description |
|---|---|---|
| team_id * | integer | Team id (from plaky_list_teams). |
{
"name": "plaky_get_team",
"title": "Get a team",
"description": "Get one team by id, with its members. Plaky API: GET /v1/public/teams/{teamId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"team_id"
],
"properties": {
"team_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Team id (from plaky_list_teams).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a team",
"readOnlyHint": true
}
}List spaces in the workspace. Pass expand=['board'] to include each space's boards. Plaky API: GET /v1/public/spaces.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-indexed (default 1). |
| expand | array | Use 'board' to include boards inside each space. |
| page_size | integer | Results per page (default 50). |
{
"name": "plaky_list_spaces",
"title": "List spaces",
"description": "List spaces in the workspace. Pass expand=['board'] to include each space's boards. Plaky API: GET /v1/public/spaces.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number, 1-indexed (default 1).",
"exclusiveMinimum": 0
},
"expand": {
"type": "array",
"items": {
"enum": [
"board"
],
"type": "string"
},
"description": "Use 'board' to include boards inside each space."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Results per page (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List spaces",
"readOnlyHint": true
}
}Get one space by id. Pass expand=['board'] to include its boards. Plaky API: GET /v1/public/spaces/{spaceId}.
| Parameter | Type | Description |
|---|---|---|
| expand | array | Use 'board' to include boards. |
| space_id * | integer | Space id (from plaky_list_spaces). |
{
"name": "plaky_get_space",
"title": "Get a space",
"description": "Get one space by id. Pass expand=['board'] to include its boards. Plaky API: GET /v1/public/spaces/{spaceId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id"
],
"properties": {
"expand": {
"type": "array",
"items": {
"enum": [
"board"
],
"type": "string"
},
"description": "Use 'board' to include boards."
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a space",
"readOnlyHint": true
}
}List the boards in one space. Plaky API: GET /v1/public/spaces/{spaceId}/boards.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-indexed (default 1). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| page_size | integer | Results per page (default 50). |
{
"name": "plaky_list_boards",
"title": "List boards in a space",
"description": "List the boards in one space. Plaky API: GET /v1/public/spaces/{spaceId}/boards.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number, 1-indexed (default 1).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Results per page (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List boards in a space",
"readOnlyHint": true
}
}Get one board: its fields (keys, titles, types, allowed values) and groups. Call it first to learn the field keys before you set values. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}.
| Parameter | Type | Description |
|---|---|---|
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
{
"name": "plaky_get_board",
"title": "Get a board",
"description": "Get one board: its fields (keys, titles, types, allowed values) and groups. Call it first to learn the field keys before you set values. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id"
],
"properties": {
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a board",
"readOnlyHint": true
}
}List the item groups (sections) of a board. Use their ids for plaky_create_item and plaky_move_item_to_group. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/item-groups.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-indexed (default 1). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| page_size | integer | Results per page (default 50). |
{
"name": "plaky_list_item_groups",
"title": "List item groups",
"description": "List the item groups (sections) of a board. Use their ids for plaky_create_item and plaky_move_item_to_group. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/item-groups.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number, 1-indexed (default 1).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Results per page (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List item groups",
"readOnlyHint": true
}
}List items on a board, optionally in one board view or under one parent item. subitems_behaviour: INCLUDE (default), EXCLUDE or EMBED. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-indexed (default 1). |
| expand | array | Relationships to return as full objects instead of ids. |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| page_size | integer | Results per page (default 50). |
| parent_id | integer | Only subitems of this parent item. |
| board_view_id | integer | Only items shown in this board view. |
| subitems_behaviour | string | How subitems appear (default INCLUDE). |
{
"name": "plaky_list_items",
"title": "List items on a board",
"description": "List items on a board, optionally in one board view or under one parent item. subitems_behaviour: INCLUDE (default), EXCLUDE or EMBED. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number, 1-indexed (default 1).",
"exclusiveMinimum": 0
},
"expand": {
"type": "array",
"items": {
"enum": [
"space",
"board",
"group",
"createdBy",
"parent",
"subscriptions",
"fields"
],
"type": "string"
},
"description": "Relationships to return as full objects instead of ids."
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Results per page (default 50).",
"exclusiveMinimum": 0
},
"parent_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only subitems of this parent item.",
"exclusiveMinimum": 0
},
"board_view_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only items shown in this board view.",
"exclusiveMinimum": 0
},
"subitems_behaviour": {
"enum": [
"INCLUDE",
"EXCLUDE",
"EMBED"
],
"type": "string",
"description": "How subitems appear (default INCLUDE)."
}
}
},
"annotations": {
"title": "List items on a board",
"readOnlyHint": true
}
}Get one item with its field values, group and subitem count. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}.
| Parameter | Type | Description |
|---|---|---|
| expand | array | Relationships to return as full objects instead of ids. |
| item_id * | integer | Item id (from plaky_list_items). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
{
"name": "plaky_get_item",
"title": "Get an item",
"description": "Get one item with its field values, group and subitem count. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id",
"item_id"
],
"properties": {
"expand": {
"type": "array",
"items": {
"enum": [
"space",
"board",
"group",
"createdBy",
"parent",
"subscriptions",
"fields"
],
"type": "string"
},
"description": "Relationships to return as full objects instead of ids."
},
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item id (from plaky_list_items).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an item",
"readOnlyHint": true
}
}List the subitems of one item. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}/sub-items.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, 1-indexed (default 1). |
| expand | array | Relationships to return as full objects instead of ids. |
| item_id * | integer | Item id (from plaky_list_items). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| page_size | integer | Results per page (default 50). |
{
"name": "plaky_list_subitems",
"title": "List subitems",
"description": "List the subitems of one item. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}/sub-items.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id",
"item_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number, 1-indexed (default 1).",
"exclusiveMinimum": 0
},
"expand": {
"type": "array",
"items": {
"enum": [
"space",
"board",
"group",
"createdBy",
"parent",
"subscriptions",
"fields"
],
"type": "string"
},
"description": "Relationships to return as full objects instead of ids."
},
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item id (from plaky_list_items).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Results per page (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List subitems",
"readOnlyHint": true
}
}List the comments on one item, with replies and reactions. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}/comments.
| Parameter | Type | Description |
|---|---|---|
| item_id * | integer | Item id (from plaky_list_items). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
{
"name": "plaky_list_item_comments",
"title": "List item comments",
"description": "List the comments on one item, with replies and reactions. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}/comments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id",
"item_id"
],
"properties": {
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item id (from plaky_list_items).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List item comments",
"readOnlyHint": true
}
}List the files attached to one item (name, size, type, uploader). Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}/files.
| Parameter | Type | Description |
|---|---|---|
| item_id * | integer | Item id (from plaky_list_items). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
{
"name": "plaky_list_item_files",
"title": "List item files",
"description": "List the files attached to one item (name, size, type, uploader). Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}/files.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id",
"item_id"
],
"properties": {
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item id (from plaky_list_items).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List item files",
"readOnlyHint": true
}
}Return a short-lived presigned download URL for one item file (see expiresInSeconds). The file bytes are not returned. Plaky API: GET .../files/{itemFileId}/download.
| Parameter | Type | Description |
|---|---|---|
| item_id * | integer | Item id (from plaky_list_items). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| item_file_id * | integer | File id (from plaky_list_item_files). |
{
"name": "plaky_get_item_file_download_url",
"title": "Get a file download link",
"description": "Return a short-lived presigned download URL for one item file (see expiresInSeconds). The file bytes are not returned. Plaky API: GET .../files/{itemFileId}/download.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id",
"item_id",
"item_file_id"
],
"properties": {
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item id (from plaky_list_items).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"item_file_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "File id (from plaky_list_item_files).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a file download link",
"readOnlyHint": true
}
}Create an item on a board, or a subitem when parent_id is set. Fields map a field key or title to a value. Writes data: creates a new item on each call. Plaky API: POST /v1/public/spaces/{spaceId}/boards/{boardId}/items.
| Parameter | Type | Description |
|---|---|---|
| title | string | Item title (default 'New Item', or 'New Subitem'). |
| fields | object | Field values keyed by field key or title. |
| board_id * | integer | Board id (from plaky_list_boards). |
| group_id | integer | Item group id to place the item in (from plaky_list_item_groups). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| parent_id | integer | Parent item id: creates a subitem under it. |
{
"name": "plaky_create_item",
"title": "Create an item or subitem",
"description": "Create an item on a board, or a subitem when parent_id is set. Fields map a field key or title to a value. Writes data: creates a new item on each call. Plaky API: POST /v1/public/spaces/{spaceId}/boards/{boardId}/items.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id"
],
"properties": {
"title": {
"type": "string",
"maxLength": 255,
"description": "Item title (default 'New Item', or 'New Subitem')."
},
"fields": {
"type": "object",
"description": "Field values keyed by field key or title.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
],
"description": "Field value by type: text or number as-is; status as label or id; tag as array of labels or ids; date as ISO-8601 string; timeline as {start,end}; person as {users:[{id|email}],teams:[{id|title}]}; link as URL or {url,displayText}."
}
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"group_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item group id to place the item in (from plaky_list_item_groups).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"parent_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Parent item id: creates a subitem under it.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create an item or subitem",
"destructiveHint": true
}
}Set the value of one field on an item. The field is a key ('status-1') or a title ('Status'). Setting the same value again changes nothing. Plaky API: PATCH .../items/{itemId}/fields/{itemFieldKey}.
| Parameter | Type | Description |
|---|---|---|
| value * | any | Field value by type: text or number as-is; status as label or id; tag as array of labels or ids; date as ISO-8601 string; timeline as {start,end}; person as {users:[{id|email}],teams:[{id|title}]}; link as URL or {url,displayText}. |
| item_id * | integer | Item id (from plaky_list_items). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| field_key * | string | Field key or field title, from plaky_get_board. |
{
"name": "plaky_update_item_field",
"title": "Set one field value",
"description": "Set the value of one field on an item. The field is a key ('status-1') or a title ('Status'). Setting the same value again changes nothing. Plaky API: PATCH .../items/{itemId}/fields/{itemFieldKey}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id",
"item_id",
"field_key",
"value"
],
"properties": {
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
],
"description": "Field value by type: text or number as-is; status as label or id; tag as array of labels or ids; date as ISO-8601 string; timeline as {start,end}; person as {users:[{id|email}],teams:[{id|title}]}; link as URL or {url,displayText}."
},
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item id (from plaky_list_items).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"field_key": {
"type": "string",
"minLength": 1,
"description": "Field key or field title, from plaky_get_board."
}
}
},
"annotations": {
"title": "Set one field value",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Move an item to another item group on the same board. The item is added to the end of the target group. Plaky API: PATCH .../items/{itemId}/group.
| Parameter | Type | Description |
|---|---|---|
| item_id * | integer | Item id (from plaky_list_items). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| item_group_id * | integer | Destination item group id (from plaky_list_item_groups). |
{
"name": "plaky_move_item_to_group",
"title": "Move an item to a group",
"description": "Move an item to another item group on the same board. The item is added to the end of the target group. Plaky API: PATCH .../items/{itemId}/group.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id",
"item_id",
"item_group_id"
],
"properties": {
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item id (from plaky_list_items).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"item_group_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Destination item group id (from plaky_list_item_groups).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Move an item to a group",
"destructiveHint": true
}
}Add a comment to an item, or a reply when reply_to_comment_id is set. Writes data: each call posts a new comment. Plaky API: POST .../items/{itemId}/comments.
| Parameter | Type | Description |
|---|---|---|
| text * | string | Comment text. |
| item_id * | integer | Item id (from plaky_list_items). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| reply_to_comment_id | integer | Comment id to reply to (from plaky_list_item_comments). |
{
"name": "plaky_add_item_comment",
"title": "Add a comment",
"description": "Add a comment to an item, or a reply when reply_to_comment_id is set. Writes data: each call posts a new comment. Plaky API: POST .../items/{itemId}/comments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id",
"item_id",
"text"
],
"properties": {
"text": {
"type": "string",
"minLength": 1,
"description": "Comment text."
},
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item id (from plaky_list_items).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"reply_to_comment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Comment id to reply to (from plaky_list_item_comments).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Add a comment",
"destructiveHint": true
}
}Set the emoji reactions the API key's user leaves on one comment. Replaces the current reactions; an empty list removes them. Emoji codes are hex, e.g. '1f44d' (thumbs up). Plaky API: PUT .../comments/{itemCommentId}/reactions.
| Parameter | Type | Description |
|---|---|---|
| item_id * | integer | Item id (from plaky_list_items). |
| board_id * | integer | Board id (from plaky_list_boards). |
| space_id * | integer | Space id (from plaky_list_spaces). |
| comment_id * | integer | Comment id (from plaky_list_item_comments). |
| reaction_codes * | array | Emoji hex codes, e.g. ['1f44d']. Empty list removes all. |
{
"name": "plaky_set_comment_reactions",
"title": "Set your reactions on a comment",
"description": "Set the emoji reactions the API key's user leaves on one comment. Replaces the current reactions; an empty list removes them. Emoji codes are hex, e.g. '1f44d' (thumbs up). Plaky API: PUT .../comments/{itemCommentId}/reactions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"space_id",
"board_id",
"item_id",
"comment_id",
"reaction_codes"
],
"properties": {
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Item id (from plaky_list_items).",
"exclusiveMinimum": 0
},
"board_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Board id (from plaky_list_boards).",
"exclusiveMinimum": 0
},
"space_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Space id (from plaky_list_spaces).",
"exclusiveMinimum": 0
},
"comment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Comment id (from plaky_list_item_comments).",
"exclusiveMinimum": 0
},
"reaction_codes": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Emoji hex codes, e.g. ['1f44d']. Empty list removes all."
}
}
},
"annotations": {
"title": "Set your reactions on a comment",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Plaky, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which items on our product roadmap board are still in To do?"; "Create a new task called 'Fix checkout timeout' in the Engineering space, in the Backlog group."; "Add a comment to item 42 saying the fix is in review.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Plaky data. Free plan: 50 tool calls per month. Run plaky_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run plaky_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run plaky_upgrade without a plan: it returns both plans, each with a payment link for the user to open. plaky_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.