Kanban boards and sprints planned from a backlog, with columns, cards, card fields, links, comments and files.
A board is a resource with kind board. Set its mode to kanban or sprints with board_update_settings.
Built-in card fields are keyed by name: points, assignee, epic, links and files. Custom fields and multiselect values have 32-character hex ids.
To attach a file to a card, upload it with the board as space_id and the card as card_id. See Upload a file.
The examples use the callTool helper. To connect, see the Quickstart or Authentication.
Boards
A limited agent can make only the changes its permissions allow. Read-only access allows no changes. See Access and permissions.
| Board | Allows |
|---|---|
create:<column_id> | Create cards in the column. |
move:<from>:<to> | Move cards from one column to another. Each direction is a separate permission. |
reorder | Reorder cards within a column. |
edit | Edit card titles, descriptions, field values and links. |
comment | Comment on cards. |
attach | Attach files to cards. |
delete | Delete cards. |
columns | Add, rename, reorder and delete columns, and set the board’s mode. |
fields | Add, change, reorder and remove card fields and multiselect values, and set the epic field’s source board. |
sprints | Plan, start, complete and delete sprints. Plan cards into sprints, and set the term used for sprints, the sprint length and the backlog column. |
Boards
These limits apply alongside the general limits.
| What | Limit |
|---|---|
| Card titles | 1–200 characters |
| Column, card field and multiselect value names | 1–100 characters |
| Card descriptions and comments | 10,000 characters |
| Text field values | 500 characters |
| Tags | 20 per card, 40 characters each |
Tools · Boards
Returns a board’s settings, columns, cards, sprints and enabled card fields. Each card includes its timeline, attachments, field values, links and sprint.
project_id string Requiredspace_id string Requiredlist_spaces.An object with settings, columns, cards, sprints and fields. settings includes mode, sprint_days, sprint_noun and the backlog column (see board_update_settings). columns and cards are each ordered by position. In each column, done marks finished work, wip_limit sets the target card count, and hide_after_days and show_latest hide older cards behind View all (see board_set_column_options). sprints are in run order, each planned, active or completed, with committed and finished totals. fields lists enabled fields in order (see board_list_fields). The epic field’s source identifies the board that supplies its epics. All cards are returned, including hidden cards, with entered_at (column entry time), sprint_id (null if none) and planned_at. Each card’s values are keyed by field. Values are a number (points, number), an account id (assignee, person), an epic card as owner_id/project_id/space_id/card_id, a date (YYYY-MM-DD), text, space-separated option ids (multiselect) or newline-separated tags. links lists each target as owner_id/project_id/space_id/card_id, with a file’s SHA-256 replacing the card id. Only targets the reader can open are included. mentions lists people mentioned in the description or comments.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_get",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be"
}
}
}'{
"columns": [
{
"id": "6aba03474215a03ee749e0ede18bfbbe",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "To do",
"position": 0,
"hide_after_days": null,
"show_latest": null,
"done": false,
"wip_limit": null,
"forward_to": null
},
{
"id": "df86cca14ff38b6b6bebc84ba5238929",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "In progress",
"position": 1,
"hide_after_days": null,
"show_latest": null,
"done": false,
"wip_limit": 3,
"forward_to": null
},
{
"id": "91b72da9b3075f1ac618a998d73abe38",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Done",
"position": 2,
"hide_after_days": null,
"show_latest": null,
"done": true,
"wip_limit": null,
"forward_to": null
}
],
"cards": [
{
"id": "29f85ca6fa7995f67baef6c5463c4adf",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"number": 12,
"column_id": "91b72da9b3075f1ac618a998d73abe38",
"title": "Draft the announcement",
"description": "One page, plain language.",
"position": 0,
"created_at": "2026-09-30T23:46:04.313Z",
"sprint_id": "34f07d552e04fb1d1f6a5d0a4348ba55",
"entered_at": "2026-09-30T23:46:04.330Z",
"planned_at": "2026-09-30T23:46:04.302Z",
"mentions": [],
"timeline": [
{
"id": "de8285ff8a82d41dd70d6feaabcc5c85",
"kind": "move",
"body": "Moved from To do to Done",
"created_at": "2026-09-30T23:46:04.323Z",
"document_id": null,
"mentions": []
},
{
"id": "da554384dbf8514c1675604cb1521c57",
"kind": "comment",
"body": "Ready for review.",
"created_at": "2026-09-30T23:46:04.331Z",
"document_id": null,
"mentions": []
}
],
"attachments": [],
"values": {
"points": 3,
"assignee": "b8bc98d760d80b652c1b714e88c31882",
"epic": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/3a1fc1159e31d94b92d846a791d32449/db4ea7c578b6c642ce7efcd85aeb53df",
"b937b46fd929406dc5882e31259ba8e4": "ab7de1fa0ee52971cd8b1baf895a9052"
},
"links": [
{
"id": "e30b56d547554f32c38ac1bf8e2f2516",
"field": "links",
"target": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/37ac76ac06b2d9cca86ef4fb6feb79be/592509f513931506e2ba56f78780a0a2"
}
]
}
],
"settings": {
"mode": "sprints",
"sprint_days": 14,
"sprint_noun": "Sprint",
"backlog": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/37ac76ac06b2d9cca86ef4fb6feb79be/7c1d0e8a2f4b49d3a6e5b8c9d0f1a2b3",
"card_prefix": "T"
},
"sprints": [
{
"id": "34f07d552e04fb1d1f6a5d0a4348ba55",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Sprint 1",
"goal": "Announce the launch.",
"starts_on": "2026-10-01",
"ends_on": "2026-10-14",
"started_at": "2026-09-30T23:46:04.305Z",
"completed_at": null,
"status": "active",
"committed_cards": 1,
"committed_points": 3,
"done_cards": null,
"done_points": null,
"open_cards": null,
"created_at": "2026-09-30T23:46:04.300Z"
}
],
"fields": [
{
"key": "points",
"kind": "points",
"name": "Points",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a0",
"options": []
},
{
"key": "assignee",
"kind": "assignee",
"name": "Assignee",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a1",
"options": []
},
{
"key": "epic",
"kind": "epic",
"name": "Epic",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a2",
"options": [],
"source": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/3a1fc1159e31d94b92d846a791d32449"
},
{
"key": "links",
"kind": "links",
"name": "Linked cards",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a3",
"options": []
},
{
"key": "b937b46fd929406dc5882e31259ba8e4",
"kind": "select",
"name": "Platform",
"builtin": false,
"enabled": true,
"on_card": true,
"position": "a5",
"options": [
{
"id": "ab7de1fa0ee52971cd8b1baf895a9052",
"name": "iOS"
},
{
"id": "3e0642899f7ab6855efd005c2fc9e45e",
"name": "Android"
}
]
}
]
}Tools · Boards
Adds a column at the end of a board.
project_id string Requiredspace_id string Requiredlist_spaces.name string RequiredThe new column.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_add_column",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Blocked"
}
}
}'{
"id": "238add55c1117ddbd284941b671d24d2",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Blocked",
"position": 3,
"hide_after_days": null,
"show_latest": null,
"done": false,
"wip_limit": null,
"forward_to": null
}Tools · Boards
Renames a board column.
project_id string Requiredspace_id string Requiredlist_spaces.column_id string Requiredname string RequiredThe column’s id and new name.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_rename_column",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"column_id": "df86cca14ff38b6b6bebc84ba5238929",
"name": "Doing"
}
}
}'{
"id": "df86cca14ff38b6b6bebc84ba5238929",
"name": "Doing"
}Tools · Boards
Configures a column. Omitted options are unchanged. done marks finished work. Sprints count the column’s cards as done, and burndowns count them from their column entry time. wip_limit sets a target card count, and the board flags the column when the count is exceeded. hide_after_days and show_latest hide older cards by entry time, oldest first. Hidden cards stay in place, appear under View all, and are still returned by board_get. forward_to sends every card moved into the column to a column on another board, with its title, description and shared field values. Comments, history and files stay behind. The moved card remains visible here with a link for hide_after_days days, or one day if unset. Cards can’t be created in a forwarding column.
project_id string Requiredspace_id string Requiredlist_spaces.column_id string Requireddone boolean wip_limit integer | null hide_after_days integer | null show_latest integer | null forward_to string | null owner_id/project_id/space_id/column_id. The destination can’t itself forward cards. Pass null to stop forwarding.The updated column.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_set_column_options",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"column_id": "91b72da9b3075f1ac618a998d73abe38",
"done": true,
"hide_after_days": 14,
"show_latest": 20
}
}
}'{
"id": "91b72da9b3075f1ac618a998d73abe38",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Done",
"position": 2,
"hide_after_days": 14,
"show_latest": 20,
"done": true,
"wip_limit": null,
"forward_to": null
}Tools · Boards
Moves a column one place left or right. Moving past either end has no effect.
project_id string Requiredspace_id string Requiredlist_spaces.column_id string Requireddirection enum Requiredup moves it one place left, and down one place right.The board’s columns in their new order.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_move_column",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"column_id": "91b72da9b3075f1ac618a998d73abe38",
"direction": "up"
}
}
}'[
{
"id": "6aba03474215a03ee749e0ede18bfbbe",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "To do",
"position": 0,
"hide_after_days": null,
"show_latest": null,
"done": false,
"wip_limit": null,
"forward_to": null
},
{
"id": "91b72da9b3075f1ac618a998d73abe38",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Done",
"position": 1,
"hide_after_days": null,
"show_latest": null,
"done": false,
"wip_limit": null,
"forward_to": null
},
{
"id": "df86cca14ff38b6b6bebc84ba5238929",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "In progress",
"position": 2,
"hide_after_days": null,
"show_latest": null,
"done": false,
"wip_limit": null,
"forward_to": null
}
]Tools · Boards
Deletes an empty column. A board must keep at least one column.
project_id string Requiredspace_id string Requiredlist_spaces.column_id string RequiredThe deleted column’s id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_delete_column",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"column_id": "238add55c1117ddbd284941b671d24d2"
}
}
}'{
"deleted": "238add55c1117ddbd284941b671d24d2"
}Tools · Boards
Updates a board’s settings. Omitted settings are unchanged. In kanban mode, the board shows all cards flowing through its columns. In sprints mode, cards are planned from the backlog column into sprints, one sprint runs at a time, and the board shows the active sprint’s cards. People can switch the view to another sprint, to unplanned cards or to all cards. Switching modes keeps all cards, columns and sprints.
project_id string Requiredspace_id string Requiredlist_spaces.mode enum kanban or sprints.sprint_days integer sprint_noun string card_prefix string backlog string | null owner_id/project_id/space_id/column_id. It can be on this board or any board the agent can open. Cards planned from another board move to this one. Pass null for no backlog.The board’s settings.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_update_settings",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"mode": "sprints"
}
}
}'{
"mode": "sprints",
"sprint_days": 14,
"sprint_noun": "Sprint",
"backlog": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/37ac76ac06b2d9cca86ef4fb6feb79be/7c1d0e8a2f4b49d3a6e5b8c9d0f1a2b3",
"card_prefix": "T"
}Tools · Sprints
Plans a new sprint, or edits the planned or active sprint with the given id. Completed sprints can’t be edited.
project_id string Requiredspace_id string Requiredlist_spaces.id string name string Requiredgoal string starts_on string | null YYYY-MM-DD. Omit to keep the current date, or pass null to clear it.ends_on string | null YYYY-MM-DD, on or after the start. Omit to keep the current date, or pass null to clear it.The sprint, as returned by board_get.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_save_sprint",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Sprint 1",
"goal": "Announce the launch.",
"starts_on": "2026-10-01",
"ends_on": "2026-10-14"
}
}
}'{
"id": "34f07d552e04fb1d1f6a5d0a4348ba55",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Sprint 1",
"goal": "Announce the launch.",
"starts_on": "2026-10-01",
"ends_on": "2026-10-14",
"started_at": null,
"completed_at": null,
"status": "planned",
"committed_cards": null,
"committed_points": null,
"done_cards": null,
"done_points": null,
"open_cards": null,
"created_at": "2026-09-30T23:46:04.300Z"
}Tools · Sprints
Starts a planned sprint and records its cards and points as the sprint’s commitment. Only one sprint can run at a time, so complete the active sprint first.
project_id string Requiredspace_id string Requiredlist_spaces.sprint_id string Requiredstarts_on string YYYY-MM-DD. Defaults to the planned start date, or today if there is none.ends_on string YYYY-MM-DD. Defaults to the planned end date, or sprint_days after the start if there is none.The sprint, now active.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_start_sprint",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"sprint_id": "34f07d552e04fb1d1f6a5d0a4348ba55"
}
}
}'{
"id": "34f07d552e04fb1d1f6a5d0a4348ba55",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Sprint 1",
"goal": "Announce the launch.",
"starts_on": "2026-10-01",
"ends_on": "2026-10-14",
"started_at": "2026-09-30T23:46:04.305Z",
"completed_at": null,
"status": "active",
"committed_cards": 1,
"committed_points": 3,
"done_cards": null,
"done_points": null,
"open_cards": null,
"created_at": "2026-09-30T23:46:04.300Z"
}Tools · Sprints
Completes the active sprint. Cards in done columns stay with the sprint (done_cards, done_points). The remaining cards (open_cards) move to another planned sprint or to the backlog.
project_id string Requiredspace_id string Requiredlist_spaces.sprint_id string Requiredmove_to string The sprint, now completed.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_complete_sprint",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"sprint_id": "34f07d552e04fb1d1f6a5d0a4348ba55"
}
}
}'{
"id": "34f07d552e04fb1d1f6a5d0a4348ba55",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"name": "Sprint 1",
"goal": "Announce the launch.",
"starts_on": "2026-10-01",
"ends_on": "2026-10-14",
"started_at": "2026-09-30T23:46:04.305Z",
"completed_at": "2026-09-30T23:46:04.360Z",
"status": "completed",
"committed_cards": 1,
"committed_points": 3,
"done_cards": 1,
"done_points": 3,
"open_cards": 0,
"created_at": "2026-09-30T23:46:04.300Z"
}Tools · Sprints
Deletes a planned or completed sprint. Its cards become unplanned, and unfinished cards return to the backlog. Complete an active sprint before deleting it.
project_id string Requiredspace_id string Requiredlist_spaces.sprint_id string RequiredThe deleted sprint’s id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_delete_sprint",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"sprint_id": "ddf893caf83381f5afe3c16310b661fa"
}
}
}'{
"deleted": "ddf893caf83381f5afe3c16310b661fa"
}Tools · Sprints
Plans a card on this board into a planned or active sprint, moving it out of the backlog column. With sprint_id null, moves the card into the backlog column, and onto that column’s board if needed. If there is no backlog column, only removes the card from its sprint.
project_id string Requiredspace_id string Requiredlist_spaces.card_id string Requiredsprint_id string | null RequiredThe card, as returned by board_get.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_set_card_sprint",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"card_id": "29f85ca6fa7995f67baef6c5463c4adf",
"sprint_id": "34f07d552e04fb1d1f6a5d0a4348ba55"
}
}
}'{
"id": "29f85ca6fa7995f67baef6c5463c4adf",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"number": 12,
"column_id": "6aba03474215a03ee749e0ede18bfbbe",
"title": "Draft the announcement",
"description": "One page, plain language.",
"position": 0,
"created_at": "2026-09-30T23:46:04.313Z",
"sprint_id": "34f07d552e04fb1d1f6a5d0a4348ba55",
"entered_at": "2026-09-30T23:46:04.313Z",
"planned_at": "2026-09-30T23:46:04.302Z",
"mentions": [],
"timeline": [],
"attachments": [],
"values": {},
"links": []
}Tools · Sprints
Plans any card into a planned or active sprint on this board. A card from another board, such as one in a backlog column, moves to this board’s first non-backlog column with its title, description and shared field values. Comments, history and files stay behind.
project_id string Requiredspace_id string Requiredlist_spaces.target string Requiredowner_id/project_id/space_id/card_id.sprint_id string RequiredThe card, now on this board, as returned by board_get.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_plan_card",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"target": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/37ac76ac06b2d9cca86ef4fb6feb79be/592509f513931506e2ba56f78780a0a2",
"sprint_id": "34f07d552e04fb1d1f6a5d0a4348ba55"
}
}
}'{
"id": "592509f513931506e2ba56f78780a0a2",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"number": 12,
"column_id": "6aba03474215a03ee749e0ede18bfbbe",
"title": "Draft the announcement",
"description": "One page, plain language.",
"position": 0,
"created_at": "2026-09-30T23:46:04.313Z",
"sprint_id": "34f07d552e04fb1d1f6a5d0a4348ba55",
"entered_at": "2026-09-30T23:46:04.313Z",
"planned_at": "2026-09-30T23:46:04.302Z",
"mentions": [],
"timeline": [
{
"id": "de8285ff8a82d41dd70d6feaabcc5c85",
"kind": "move",
"body": "Moved from To do to Done",
"created_at": "2026-09-30T23:46:04.323Z",
"document_id": null,
"mentions": []
}
],
"attachments": [],
"values": {},
"links": []
}Tools · Boards
Creates a card in a column, or edits the card with the given id and moves it if column_id differs. Moves are recorded in the card’s timeline.
project_id string Requiredspace_id string Requiredlist_spaces.id string column_id string Requiredtitle string Requireddescription string mentions string[] list_people. Include each person’s @handle in the description.sprint_id string board_set_card_sprint.The saved card, with its sprint_id. To change its position within the column, use board_move_card.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_save_card",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"column_id": "6aba03474215a03ee749e0ede18bfbbe",
"title": "Draft the announcement",
"description": "One page, plain language."
}
}
}'{
"id": "29f85ca6fa7995f67baef6c5463c4adf",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"number": 12,
"column_id": "6aba03474215a03ee749e0ede18bfbbe",
"title": "Draft the announcement",
"description": "One page, plain language.",
"position": 0,
"created_at": "2026-09-30T23:46:04.313Z",
"sprint_id": null
}Tools · Boards
Deletes a card from a board.
project_id string Requiredspace_id string Requiredlist_spaces.id string RequiredThe deleted card’s id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_delete_card",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"id": "29f85ca6fa7995f67baef6c5463c4adf"
}
}
}'{
"deleted": "29f85ca6fa7995f67baef6c5463c4adf"
}Tools · Boards
Moves a card to another column or reorders it within its column, placing it before another card or at the end. Column changes are recorded in the card’s timeline.
project_id string Requiredspace_id string Requiredlist_spaces.card_id string Requiredcolumn_id string Requiredbefore_id string The card, as returned by board_get. If the column forwards cards (see forward_to in board_set_column_options), returns the card’s id and moved_to, the new card as owner_id/project_id/space_id/card_id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_move_card",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"card_id": "29f85ca6fa7995f67baef6c5463c4adf",
"column_id": "91b72da9b3075f1ac618a998d73abe38"
}
}
}'{
"id": "29f85ca6fa7995f67baef6c5463c4adf",
"board_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"number": 12,
"column_id": "91b72da9b3075f1ac618a998d73abe38",
"title": "Draft the announcement",
"description": "One page, plain language.",
"position": 0,
"created_at": "2026-09-30T23:46:04.313Z",
"sprint_id": "34f07d552e04fb1d1f6a5d0a4348ba55",
"entered_at": "2026-09-30T23:46:04.330Z",
"planned_at": "2026-09-30T23:46:04.302Z",
"mentions": [],
"timeline": [
{
"id": "de8285ff8a82d41dd70d6feaabcc5c85",
"kind": "move",
"body": "Moved from To do to Done",
"created_at": "2026-09-30T23:46:04.323Z",
"document_id": null,
"mentions": []
}
],
"attachments": [],
"values": {},
"links": []
}Tools · Boards
Adds a comment to a card’s timeline. To mention someone, write @handle and pass their id in mentions.
project_id string Requiredspace_id string Requiredlist_spaces.card_id string Requiredbody string Requiredmentions string[] list_people. Include each person’s @handle in the text.The comment, as shown in the card’s timeline.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_comment_on_card",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"card_id": "29f85ca6fa7995f67baef6c5463c4adf",
"body": "Ready for review."
}
}
}'{
"id": "da554384dbf8514c1675604cb1521c57",
"kind": "comment",
"body": "Ready for review.",
"created_at": "2026-09-30T23:46:04.331Z",
"document_id": null,
"mentions": []
}Tools · Card fields
Sets a card’s value for an enabled field. For card and file links, use board_link_card.
project_id string Requiredspace_id string Requiredlist_spaces.card_id string Requiredfield string Requiredpoints, assignee, epic, links, files) or a custom field’s id.values string[] Requiredlist_people. Epics take a card from the epic field’s source board as owner_id/project_id/space_id/card_id. Dates use YYYY-MM-DD. Text allows up to 500 characters. Multiselect fields take all chosen option ids. Tags fields take all tags, up to 20 with 40 characters each. An empty list clears the field.The card’s values, keyed by field.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_set_card_value",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"card_id": "29f85ca6fa7995f67baef6c5463c4adf",
"field": "points",
"values": [
"3"
]
}
}
}'{
"points": 3,
"assignee": "b8bc98d760d80b652c1b714e88c31882",
"epic": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/3a1fc1159e31d94b92d846a791d32449/db4ea7c578b6c642ce7efcd85aeb53df",
"b937b46fd929406dc5882e31259ba8e4": "ab7de1fa0ee52971cd8b1baf895a9052"
}Tools · Card fields
Links a card to another card through the built-in links field or a custom link field (such as Blocked by), or to a file through files. Targets can be on any board or repository the agent can open, in any project. Linking an existing target again has no effect.
project_id string Requiredspace_id string Requiredlist_spaces.card_id string Requiredfield string Requiredpoints, assignee, epic, links, files) or a custom field’s id.target string Requiredowner_id/project_id/space_id/card_id. For a file, the same with the file’s SHA-256 in place of the card id. owner_id is the project’s owner (user_id in list_projects).The link, with its id, field and target.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_link_card",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"card_id": "29f85ca6fa7995f67baef6c5463c4adf",
"field": "links",
"target": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/37ac76ac06b2d9cca86ef4fb6feb79be/592509f513931506e2ba56f78780a0a2"
}
}
}'{
"id": "e30b56d547554f32c38ac1bf8e2f2516",
"field": "links",
"target": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/37ac76ac06b2d9cca86ef4fb6feb79be/592509f513931506e2ba56f78780a0a2"
}Tools · Card fields
Removes a link from a card.
project_id string Requiredspace_id string Requiredlist_spaces.card_id string Requiredlink_id string Requiredlinks.The removed link’s id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_unlink_card",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"card_id": "29f85ca6fa7995f67baef6c5463c4adf",
"link_id": "e30b56d547554f32c38ac1bf8e2f2516"
}
}
}'{
"deleted": "e30b56d547554f32c38ac1bf8e2f2516"
}Tools · Card fields
Lists all card fields on a board, in order. The five built-in kinds (points, assignee, epic, links for linked cards, files for linked files) are keyed by kind and always listed. enabled shows whether each has been added. Custom fields are keyed by id.
project_id string Requiredspace_id string Requiredlist_spaces.An array of fields, each with key, kind, name, builtin, enabled, on_card (shown on cards, not only in card details), position and multiselect options.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_list_fields",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be"
}
}
}'[
{
"key": "points",
"kind": "points",
"name": "Points",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a0",
"options": []
},
{
"key": "assignee",
"kind": "assignee",
"name": "Assignee",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a1",
"options": []
},
{
"key": "epic",
"kind": "epic",
"name": "Epic",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a2",
"options": [],
"source": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/3a1fc1159e31d94b92d846a791d32449"
},
{
"key": "links",
"kind": "links",
"name": "Linked cards",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a3",
"options": []
},
{
"key": "files",
"kind": "files",
"name": "Linked files",
"builtin": true,
"enabled": false,
"on_card": false,
"position": "a4",
"options": []
},
{
"key": "b937b46fd929406dc5882e31259ba8e4",
"kind": "select",
"name": "Platform",
"builtin": false,
"enabled": true,
"on_card": true,
"position": "a5",
"options": [
{
"id": "ab7de1fa0ee52971cd8b1baf895a9052",
"name": "iOS"
},
{
"id": "3e0642899f7ab6855efd005c2fc9e45e",
"name": "Android"
}
]
}
]Tools · Card fields
Adds a card field after the board’s existing fields. New boards have no fields. Built-in kinds (points, assignee, epic, links, files) have special behavior, are keyed by kind, and can each be added once. Other kinds can be added any number of times. Field names must be unique within a board, ignoring case.
project_id string Requiredspace_id string Requiredlist_spaces.kind enum Requiredpoints, assignee, epic, links or files (once each), or select (multiselect), text, date, link (a named link type, such as Blocked by), user (a person), tags or number.name string Requiredoptions string[] on_card boolean The new field.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_add_field",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"kind": "select",
"name": "Platform",
"options": [
"iOS",
"Android"
],
"on_card": true
}
}
}'{
"key": "b937b46fd929406dc5882e31259ba8e4",
"kind": "select",
"name": "Platform",
"builtin": false,
"enabled": true,
"on_card": true,
"position": "a5",
"options": [
{
"id": "ab7de1fa0ee52971cd8b1baf895a9052",
"name": "iOS"
},
{
"id": "3e0642899f7ab6855efd005c2fc9e45e",
"name": "Android"
}
]
}Tools · Card fields
Renames a field, sets whether it shows on cards, enables or disables a built-in field (as board_add_field and board_delete_field do), or sets the epic field’s source board. The source board’s cards are the epics. They move through that board’s columns and can have their own epics.
project_id string Requiredspace_id string Requiredlist_spaces.field string Requiredpoints, assignee, epic, links, files) or a custom field’s id.enabled boolean on_card boolean name string source string | null owner_id/project_id/space_id. It can be this board or any board the agent can open. Pass null for none.The updated field.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_update_field",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"field": "points",
"enabled": true
}
}
}'{
"key": "points",
"kind": "points",
"name": "Points",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a0",
"options": []
}Tools · Card fields
Moves a field one place in the board’s field order. Cards display fields in this order.
project_id string Requiredspace_id string Requiredlist_spaces.field string Requiredpoints, assignee, epic, links, files) or a custom field’s id.direction enum Requiredup moves it one place earlier, and down one place later.All board fields in the new order.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_move_field",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"field": "b937b46fd929406dc5882e31259ba8e4",
"direction": "up"
}
}
}'[
{
"key": "points",
"kind": "points",
"name": "Points",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a0",
"options": []
},
{
"key": "assignee",
"kind": "assignee",
"name": "Assignee",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a1",
"options": []
},
{
"key": "epic",
"kind": "epic",
"name": "Epic",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a2",
"options": [],
"source": "5761e31cd8538b7da8a3ddd4157bd632/b6909c9cf00c1d482686b5f52eadd58e/3a1fc1159e31d94b92d846a791d32449"
},
{
"key": "links",
"kind": "links",
"name": "Linked cards",
"builtin": true,
"enabled": true,
"on_card": false,
"position": "a3",
"options": []
},
{
"key": "b937b46fd929406dc5882e31259ba8e4",
"kind": "select",
"name": "Platform",
"builtin": false,
"enabled": true,
"on_card": true,
"position": "a3V",
"options": [
{
"id": "ab7de1fa0ee52971cd8b1baf895a9052",
"name": "iOS"
},
{
"id": "3e0642899f7ab6855efd005c2fc9e45e",
"name": "Android"
}
]
},
{
"key": "files",
"kind": "files",
"name": "Linked files",
"builtin": true,
"enabled": false,
"on_card": false,
"position": "a4",
"options": []
}
]Tools · Card fields
Removes a field and its values from every card. Built-in fields (points, assignee, epic, links, files) are disabled instead, and their values are kept in case the field is enabled again.
project_id string Requiredspace_id string Requiredlist_spaces.field string Requiredpoints, assignee, epic, links, files) or a custom field’s id.The deleted field’s key.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_delete_field",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"field": "b937b46fd929406dc5882e31259ba8e4"
}
}
}'{
"deleted": "b937b46fd929406dc5882e31259ba8e4"
}Tools · Card fields
Adds a multiselect value, or renames the value with the given option_id. Values must be unique within a field, ignoring case.
project_id string Requiredspace_id string Requiredlist_spaces.field string Requiredpoints, assignee, epic, links, files) or a custom field’s id.option_id string name string RequiredThe field, with its values.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_save_field_option",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"field": "b937b46fd929406dc5882e31259ba8e4",
"name": "Web"
}
}
}'{
"key": "b937b46fd929406dc5882e31259ba8e4",
"kind": "select",
"name": "Platform",
"builtin": false,
"enabled": true,
"on_card": true,
"position": "a5",
"options": [
{
"id": "ab7de1fa0ee52971cd8b1baf895a9052",
"name": "iOS"
},
{
"id": "3e0642899f7ab6855efd005c2fc9e45e",
"name": "Android"
},
{
"id": "303851768e2f30c9de92e9e458b4e1ad",
"name": "Web"
}
]
}Tools · Card fields
Removes a multiselect value from the field and from every card.
project_id string Requiredspace_id string Requiredlist_spaces.field string Requiredpoints, assignee, epic, links, files) or a custom field’s id.option_id string Requiredoptions.The removed value’s id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "board_delete_field_option",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "37ac76ac06b2d9cca86ef4fb6feb79be",
"field": "b937b46fd929406dc5882e31259ba8e4",
"option_id": "303851768e2f30c9de92e9e458b4e1ad"
}
}
}'{
"deleted": "303851768e2f30c9de92e9e458b4e1ad"
}Questions or something missing? Contact us.