### Install and Configure Advanced Trello MCP Server

Source: https://github.com/adriangrahldev/advanced-trello-mcp-server/blob/main/README.md

Commands to clone, install, build, and configure the environment for the Trello MCP server.

```bash
git clone https://github.com/adriangrahldev/advanced-trello-mcp-server.git
cd advanced-trello-mcp-server
```

```bash
npm install
```

```bash
npm run build
```

```bash
export TRELLO_API_KEY="your_api_key"
export TRELLO_API_TOKEN="your_api_token"
```

--------------------------------

### Install and Configure Trello MCP Server

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Clone the repository, install dependencies, build the project, and set Trello API credentials as environment variables.

```bash
git clone https://github.com/adriangrahldev/advanced-trello-mcp-server.git
cd advanced-trello-mcp-server
npm install
npm run build

export TRELLO_API_KEY="your_api_key"
export TRELLO_API_TOKEN="your_api_token"
```

--------------------------------

### Create a Single Trello Card

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Creates a new Trello card with optional details like name, description, due date, and start date in ISO 8601 format.

```typescript
await server.callTool("create-card", {
  name: "Implement user authentication",
  description: "Add OAuth2 login with Google and GitHub providers",
  listId: "list123",
  due: "2024-02-15T18:00:00.000Z",
  start: "2024-02-01T09:00:00.000Z"
});
```

--------------------------------

### Get Trello Boards with Custom Fields and Filters

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieve Trello boards using the 'get-boards' tool. Supports customizable fields, filters (e.g., 'open', 'starred'), and limits to control response size.

```typescript
// Get open boards with minimal fields
await server.callTool("get-boards", {
  fields: "id,name,url",
  filter: "open",
  limit: 20
});

// Get starred boards with lists included
await server.callTool("get-boards", {
  fields: "id,name,url,starred,dateLastActivity",
  filter: "starred",
  lists: "open",
  organization: true
});

// Response
{
  "boards": [
    {
      "id": "5f1a2b3c4d5e6f7g8h9i0j1k",
      "name": "Project Alpha",
      "url": "https://trello.com/b/abc123/project-alpha",
      "starred": true,
      "dateLastActivity": "2024-01-15T10:30:00.000Z"
    }
  ],
  "count": 1,
  "parameters_used": {
    "fields": "id,name,url,starred,dateLastActivity",
    "filter": "starred",
    "limit": 50,
    "organization": true,
    "lists": "none"
  }
}
```

--------------------------------

### Get Action Details

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieves detailed information about a specific action. You can include related entities like members and their fields.

```typescript
await server.callTool("get-action", {
  actionId: "action123",
  display: true,
  entities: true,
  member: true,
  memberCreator: true,
  memberCreatorFields: "fullName,username,avatarUrl"
});
```

--------------------------------

### Get Action Reactions

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieves all emoji reactions on a specific action. You can choose to include member and emoji details.

```typescript
await server.callTool("get-action-reactions", {
  actionId: "action123",
  member: true,
  emoji: true
});
```

--------------------------------

### Get Lists from a Trello Board

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieve all lists from a specified Trello board using the 'get-lists' tool. Requires the boardId as a parameter.

```typescript
await server.callTool("get-lists", {
  boardId: "5f1a2b3c4d5e6f7g8h9i0j1k"
});

// Response
[
  {"id": "list1", "name": "Backlog", "closed": false, "pos": 16384},
  {"id": "list2", "name": "In Progress", "closed": false, "pos": 32768},
  {"id": "list3", "name": "Done", "closed": false, "pos": 49152}
]
```

--------------------------------

### Fetch Cards from a Specific Trello List via MCP Resource

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Get all cards from a specific Trello list using a parameterized MCP resource template. Requires the list ID as a parameter.

```typescript
// MCP Resource URI with list ID parameter
const uri = "trello://lists/list123abc/cards";

// Response format
{
  "contents": [{
    "uri": "trello://lists/list123abc/cards",
    "text": "[{"id":"card456","name":"Task 1","desc":"Description","due":null}]"
  }]
}
```

--------------------------------

### Retrieve card attachments

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Gets all attachments associated with a card, including optional comment context.

```typescript
await server.callTool("get-card-attachments", {
  cardId: "card789"
});

// Response
[
  {
    "id": "attach1",
    "name": "screenshot-bug.png",
    "mimeType": "image/png",
    "bytes": 245632,
    "date": "2024-01-15T14:30:00.000Z",
    "isUpload": true,
    "url": "https://trello.com/1/cards/card789/attachments/attach1/download/screenshot-bug.png",
    "commentContext": "See attached screenshot showing the error state"
  },
  {
    "id": "attach2",
    "name": "design-spec.pdf",
    "mimeType": "application/pdf",
    "bytes": 1024000,
    "date": "2024-01-14T10:00:00.000Z",
    "isUpload": true,
    "url": "https://...",
    "commentContext": null
  }
]
```

--------------------------------

### Get Label by ID

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieves a label's details using its ID. You can specify which fields to return for a more concise response.

```typescript
await server.callTool("get-label", {
  labelId: "label456",
  fields: "id,name,color,idBoard"
});
```

--------------------------------

### Get Trello List Activity History

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieves the action history for a Trello list. You can filter actions by type, such as card creation or movement.

```typescript
await server.callTool("get-list-actions", {
  listId: "list123",
  filter: "createCard,moveCardToBoard"
});
```

--------------------------------

### Tool: create-list

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Creates a new list on a board with optional position specification.

```APIDOC
## Tool: create-list

### Description
Creates a new list on a board with optional position specification.

### Method
POST

### Endpoint
/tools/create-list

### Parameters
#### Request Body
- **boardId** (string) - Required - The ID of the board to create the list on.
- **name** (string) - Required - The name of the new list.
- **position** (string|integer) - Optional - The position of the new list ('top', 'bottom', or a numeric position).

### Request Example
```json
{
  "boardId": "5f1a2b3c4d5e6f7g8h9i0j1k",
  "name": "Code Review",
  "position": "top"
}
```

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the newly created list.
- **name** (string) - The name of the new list.
- **closed** (boolean) - Indicates if the list is archived.
- **pos** (integer) - The position of the new list.
- **idBoard** (string) - The ID of the board the list was created on.

### Response Example
```json
{
  "id": "newlist789",
  "name": "Code Review",
  "closed": false,
  "pos": 8192,
  "idBoard": "5f1a2b3c4d5e6f7g8h9i0j1k"
}
```
```

--------------------------------

### Create Multiple Trello Cards in Batch

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Efficiently creates several Trello cards at once. Each card can have its own name, description, list assignment, and dates.

```typescript
await server.callTool("create-cards", {
  cards: [
    {
      name: "Set up CI/CD pipeline",
      description: "Configure GitHub Actions for automated testing",
      listId: "list123",
      due: "2024-02-10T12:00:00.000Z"
    },
    {
      name: "Write API documentation",
      description: "Document all REST endpoints with OpenAPI spec",
      listId: "list123"
    },
    {
      name: "Security audit",
      listId: "list456",
      start: "2024-02-20T09:00:00.000Z",
      due: "2024-02-28T17:00:00.000Z"
    }
  ]
});
```

--------------------------------

### Create a Trello board label

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Creates a new label on a board with a specified name and color.

```typescript
await server.callTool("create-label", {
  boardId: "board123",
  name: "Critical Bug",
  color: "red"  // yellow, purple, blue, red, green, orange, black, sky, pink, lime
});

// Response
{
  "id": "label456",
  "name": "Critical Bug",
  "color": "red",
  "idBoard": "board123"
}
```

--------------------------------

### Tool: get-lists

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieves all lists from a specified board.

```APIDOC
## Tool: get-lists

### Description
Retrieves all lists from a specified board.

### Method
POST

### Endpoint
/tools/get-lists

### Parameters
#### Request Body
- **boardId** (string) - Required - The ID of the board to retrieve lists from.

### Request Example
```json
{
  "boardId": "5f1a2b3c4d5e6f7g8h9i0j1k"
}
```

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the list.
- **name** (string) - The name of the list.
- **closed** (boolean) - Indicates if the list is archived.
- **pos** (integer) - The position of the list.

### Response Example
```json
[
  {"id": "list1", "name": "Backlog", "closed": false, "pos": 16384},
  {"id": "list2", "name": "In Progress", "closed": false, "pos": 32768},
  {"id": "list3", "name": "Done", "closed": false, "pos": 49152}
]
```
```

--------------------------------

### Tool: get-boards

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieves all boards accessible to the authenticated user with customizable fields, filters, and limits.

```APIDOC
## Tool: get-boards

### Description
Retrieves all boards accessible to the authenticated user with customizable fields, filters, and limits to control response size.

### Method
POST

### Endpoint
/tools/get-boards

### Parameters
#### Request Body
- **fields** (string) - Optional - Comma-separated list of fields to include in the response.
- **filter** (string) - Optional - Filters the boards (e.g., 'open', 'closed', 'starred').
- **limit** (integer) - Optional - Maximum number of boards to return.
- **lists** (string) - Optional - Specifies whether to include lists ('open', 'closed', 'all', 'none').
- **organization** (boolean) - Optional - If true, includes organization information.

### Request Example
```json
{
  "fields": "id,name,url",
  "filter": "open",
  "limit": 20
}
```

### Response
#### Success Response (200)
- **boards** (array) - An array of board objects.
  - **id** (string) - The unique identifier for the board.
  - **name** (string) - The name of the board.
  - **url** (string) - The URL of the board.
  - **starred** (boolean) - Indicates if the board is starred.
  - **dateLastActivity** (string) - The date of the last activity on the board.
- **count** (integer) - The number of boards returned.
- **parameters_used** (object) - The parameters used for the request.

### Response Example
```json
{
  "boards": [
    {
      "id": "5f1a2b3c4d5e6f7g8h9i0j1k",
      "name": "Project Alpha",
      "url": "https://trello.com/b/abc123/project-alpha",
      "starred": true,
      "dateLastActivity": "2024-01-15T10:30:00.000Z"
    }
  ],
  "count": 1,
  "parameters_used": {
    "fields": "id,name,url,starred,dateLastActivity",
    "filter": "starred",
    "limit": 50,
    "organization": true,
    "lists": "none"
  }
}
```
```

--------------------------------

### create-label

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Creates a new label on a Trello board with a specified name and color.

```APIDOC
## POST /api/create-label

### Description
Creates a new label on a board with specified name and color.

### Method
POST

### Endpoint
/api/create-label

### Parameters
#### Request Body
- **boardId** (string) - Required - The ID of the board where the label will be created.
- **name** (string) - Required - The name of the label.
- **color** (string) - Required - The color of the label. Allowed values: yellow, purple, blue, red, green, orange, black, sky, pink, lime.

### Request Example
```json
{
  "boardId": "board123",
  "name": "Critical Bug",
  "color": "red"
}
```

### Response
#### Success Response (200)
- **id** (string) - The ID of the created label.
- **name** (string) - The name of the label.
- **color** (string) - The color of the label.
- **idBoard** (string) - The ID of the board the label belongs to.

#### Response Example
```json
{
  "id": "label456",
  "name": "Critical Bug",
  "color": "red",
  "idBoard": "board123"
}
```
```

--------------------------------

### Fetch All Trello Boards via MCP Resource

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Use the MCP resource protocol to retrieve all boards accessible to the authenticated user. The response includes board details like ID, name, and URL.

```typescript
// MCP Resource URI
const uri = "trello://boards";

// Response format
{
  "contents": [{
    "uri": "trello://boards",
    "text": "[{"id":"abc123","name":"My Board","url":"https://trello.com/b/abc123/my-board"}]"
  }]
}
```

--------------------------------

### Create a New Trello List

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Create a new list on a Trello board using the 'create-list' tool. Supports specifying the list name and an optional position ('top', 'bottom', or numeric).

```typescript
await server.callTool("create-list", {
  boardId: "5f1a2b3c4d5e6f7g8h9i0j1k",
  name: "Code Review",
  position: "top"  // "top", "bottom", or numeric position
});

// Response
{
  "id": "newlist789",
  "name": "Code Review",
  "closed": false,
  "pos": 8192,
  "idBoard": "5f1a2b3c4d5e6f7g8h9i0j1k"
}
```

--------------------------------

### Create Multiple Labels

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Use this tool to create multiple labels in a single batch operation. Provide an array of label objects, each with boardId, name, and color.

```typescript
await server.callTool("create-labels", {
  labels: [
    {boardId: "board123", name: "Bug", color: "red"},
    {boardId: "board123", name: "Feature", color: "green"},
    {boardId: "board123", name: "Documentation", color: "blue"},
    {boardId: "board123", name: "Urgent", color: "orange"}
  ]
});
```

--------------------------------

### MCP Resource: trello://boards

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Fetches all boards accessible to the authenticated user via the MCP resource protocol.

```APIDOC
## MCP Resource: trello://boards

### Description
Fetches all boards accessible to the authenticated user via MCP resource protocol.

### Method
GET

### Endpoint
trello://boards

### Response
#### Success Response (200)
- **contents** (array) - An array containing board information.
  - **uri** (string) - The MCP resource URI for the board.
  - **text** (string) - A JSON string representing an array of board objects.
    - **id** (string) - The unique identifier for the board.
    - **name** (string) - The name of the board.
    - **url** (string) - The URL of the board.

### Response Example
```json
{
  "contents": [{
    "uri": "trello://boards",
    "text": "[{\"id\":\"abc123\",\"name\":\"My Board\",\"url\":\"https://trello.com/b/abc123/my-board\"}]"
  }]
}
```
```

--------------------------------

### Utilize Trello API helper functions

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Provides methods for credential validation, URL construction, and simplified HTTP verb wrappers for Trello API operations.

```typescript
import {
  createTrelloUrl,
  validateCredentials,
  trelloGet,
  trelloPost,
  trelloPut,
  trelloDelete
} from './utils/api.js';

const credentials = { apiKey: 'KEY', apiToken: 'TOKEN' };

// Validate credentials exist
if (!validateCredentials(credentials)) {
  throw new Error('Missing API credentials');
}

// Build URL with parameters
const url = createTrelloUrl('/cards/card123', credentials, {
  fields: 'id,name,desc',
  members: 'true'
});
// Result: https://api.trello.com/1/cards/card123?key=KEY&token=TOKEN&fields=id,name,desc&members=true

// Direct API calls with automatic error handling
const card = await trelloGet('/cards/card123', credentials);
const newCard = await trelloPost('/cards', credentials, {name: 'New Card', idList: 'list123'});
const updated = await trelloPut('/cards/card123', credentials, {name: 'Updated'});
const deleted = await trelloDelete('/cards/card123', credentials);
```

--------------------------------

### Fetch Lists from a Specific Trello Board via MCP Resource

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieve all lists from a specific Trello board using a parameterized MCP resource template. Requires the board ID as a parameter.

```typescript
// MCP Resource URI with board ID parameter
const uri = "trello://boards/5f1a2b3c4d5e6f7g8h9i0j1k/lists";

// Response format
{
  "contents": [{
    "uri": "trello://boards/5f1a2b3c4d5e6f7g8h9i0j1k/lists",
    "text": "[{"id":"list123","name":"To Do","closed":false,"pos":16384}]"
  }]
}
```

--------------------------------

### MCP Resource: trello://boards/{boardId}/lists

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Retrieves all lists from a specific board using a parameterized resource template.

```APIDOC
## MCP Resource: trello://boards/{boardId}/lists

### Description
Retrieves all lists from a specific board using parameterized resource template.

### Method
GET

### Endpoint
trello://boards/{boardId}/lists

### Parameters
#### Path Parameters
- **boardId** (string) - Required - The ID of the board to retrieve lists from.

### Response
#### Success Response (200)
- **contents** (array) - An array containing list information.
  - **uri** (string) - The MCP resource URI for the lists.
  - **text** (string) - A JSON string representing an array of list objects.
    - **id** (string) - The unique identifier for the list.
    - **name** (string) - The name of the list.
    - **closed** (boolean) - Indicates if the list is archived.
    - **pos** (integer) - The position of the list.

### Response Example
```json
{
  "contents": [{
    "uri": "trello://boards/5f1a2b3c4d5e6f7g8h9i0j1k/lists",
    "text": "[{\"id\":\"list123\",\"name\":\"To Do\",\"closed\":false,\"pos\":16384}]"
  }]
}
```
```

--------------------------------

### Download card attachments

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Downloads attachments to a local directory and generates a manifest file.

```typescript
await server.callTool("download-card-attachments", {
  cardId: "card789",
  savePath: "/Users/dev/downloads/card-attachments",
  imagesOnly: true  // Only download image files (default: true)
});

// Response
{
  "savedTo": "/Users/dev/downloads/card-attachments",
  "card": "Bug Report - Login Issue",
  "filesDownloaded": 3,
  "files": [
    {"file": "01-screenshot-error.png", "mimeType": "image/png", "bytes": 245632, "commentContext": "Error screenshot"},
    {"file": "02-console-log.png", "mimeType": "image/png", "bytes": 156789, "commentContext": null},
    {"file": "03-network-tab.png", "mimeType": "image/png", "bytes": 198456, "commentContext": "Network requests"}
  ]
}

// Generated _manifest.json in savePath:
{
  "card": {
    "id": "card789",
    "name": "Bug Report - Login Issue",
    "description": "Users unable to login on Safari",
    "url": "https://trello.com/c/abc123"
  },
  "downloadedAt": "2024-01-15T16:00:00.000Z",
  "files": [...]
}
```

--------------------------------

### Perform HTTP requests with fetchWithRetry

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Executes an HTTP request with built-in exponential backoff, rate limiting, and connection reuse.

```typescript
import { fetchWithRetry } from './utils/api.js';

// Automatic retry with exponential backoff on 429/5xx errors
const response = await fetchWithRetry(
  'https://api.trello.com/1/cards/card123?key=KEY&token=TOKEN',
  {
    method: 'PUT',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({name: 'Updated Card Name'})
  }
);
const data = await response.json();
```

--------------------------------

### download-card-attachments

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Downloads all attachments from a card to a local directory, with options for file type and manifest generation.

```APIDOC
## POST /api/download-card-attachments

### Description
Downloads all attachments from a card to a local directory with OAuth authentication and manifest generation.

### Method
POST

### Endpoint
/api/download-card-attachments

### Parameters
#### Request Body
- **cardId** (string) - Required - The ID of the card whose attachments should be downloaded.
- **savePath** (string) - Required - The local directory path where attachments will be saved.
- **imagesOnly** (boolean) - Optional - If true, only downloads image files. Defaults to true.

### Request Example
```json
{
  "cardId": "card789",
  "savePath": "/Users/dev/downloads/card-attachments",
  "imagesOnly": true
}
```

### Response
#### Success Response (200)
- **savedTo** (string) - The directory where the attachments were saved.
- **card** (string) - The name of the card.
- **filesDownloaded** (integer) - The number of files successfully downloaded.
- **files** (array) - An array of downloaded file details.
  - **file** (string) - The name of the downloaded file.
  - **mimeType** (string) - The MIME type of the file.
  - **bytes** (integer) - The size of the file in bytes.
  - **commentContext** (string|null) - Contextual information related to the attachment, or null.

#### Response Example
```json
{
  "savedTo": "/Users/dev/downloads/card-attachments",
  "card": "Bug Report - Login Issue",
  "filesDownloaded": 3,
  "files": [
    {"file": "01-screenshot-error.png", "mimeType": "image/png", "bytes": 245632, "commentContext": "Error screenshot"},
    {"file": "02-console-log.png", "mimeType": "image/png", "bytes": 156789, "commentContext": null},
    {"file": "03-network-tab.png", "mimeType": "image/png", "bytes": 198456, "commentContext": "Network requests"}
  ]
}
```

### Generated Manifest
A `_manifest.json` file is generated in the `savePath` containing card details and a list of downloaded files.
```

--------------------------------

### MCP Resource: trello://lists/{listId}/cards

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Fetches all cards from a specific list using a parameterized resource template.

```APIDOC
## MCP Resource: trello://lists/{listId}/cards

### Description
Fetches all cards from a specific list using parameterized resource template.

### Method
GET

### Endpoint
trello://lists/{listId}/cards

### Parameters
#### Path Parameters
- **listId** (string) - Required - The ID of the list to retrieve cards from.

### Response
#### Success Response (200)
- **contents** (array) - An array containing card information.
  - **uri** (string) - The MCP resource URI for the cards.
  - **text** (string) - A JSON string representing an array of card objects.
    - **id** (string) - The unique identifier for the card.
    - **name** (string) - The name of the card.
    - **desc** (string) - The description of the card.
    - **due** (string|null) - The due date of the card.

### Response Example
```json
{
  "contents": [{
    "uri": "trello://lists/list123abc/cards",
    "text": "[{\"id\":\"card456\",\"name\":\"Task 1\",\"desc\":\"Description\",\"due\":null}]"
  }]
}
```
```

--------------------------------

### Action Tools API

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Endpoints for retrieving, updating, and deleting actions, as well as managing reactions.

```APIDOC
## GET /api/actions/{actionId}

### Description
Retrieves detailed information about a specific action with optional related data.

### Method
GET

### Endpoint
/api/actions/{actionId}

### Query Parameters
- **display** (boolean) - Optional - Whether to display related data.
- **entities** (boolean) - Optional - Whether to include entities.
- **member** (boolean) - Optional - Whether to include member information.
- **memberCreator** (boolean) - Optional - Whether to include member creator information.
- **memberCreatorFields** (string) - Optional - Comma-separated list of fields to include for the member creator.

### Parameters
#### Path Parameters
- **actionId** (string) - Required - The ID of the action to retrieve.

### Response
#### Success Response (200)
- **id** (string) - The ID of the action.
- **type** (string) - The type of the action.
- **date** (string) - The date and time the action occurred.
- **data** (object) - Data specific to the action type.
  - **text** (string) - The text content of the action (e.g., for comments).
  - **card** (object) - Information about the card associated with the action.
    - **id** (string) - The ID of the card.
    - **name** (string) - The name of the card.
- **memberCreator** (object) - Information about the member who created the action.
  - **id** (string) - The ID of the member.
  - **fullName** (string) - The full name of the member.
  - **username** (string) - The username of the member.
  - **avatarUrl** (string) - The URL of the member's avatar.

#### Response Example
```json
{
  "id": "action123",
  "type": "commentCard",
  "date": "2024-01-15T14:30:00.000Z",
  "data": {
    "text": "This needs review before deployment",
    "card": {"id": "card789", "name": "Deploy feature X"}
  },
  "memberCreator": {
    "id": "member456",
    "fullName": "Jane Developer",
    "username": "janedev",
    "avatarUrl": "https://..."
  }
}
```

## PUT /api/actions/{actionId}

### Description
Updates the text content of a comment action.

### Method
PUT

### Endpoint
/api/actions/{actionId}

### Request Body
- **actionId** (string) - Required - The ID of the action to update.
- **text** (string) - Required - The new text content for the action.

### Request Example
```json
{
  "actionId": "action123",
  "text": "UPDATED: This has been reviewed and approved for deployment"
}
```

### Response
#### Success Response (200)
- **id** (string) - The ID of the updated action.
- **type** (string) - The type of the action.
- **data** (object) - The updated data for the action.
  - **text** (string) - The updated text content.

#### Response Example
```json
{
  "id": "action123",
  "type": "commentCard",
  "data": {
    "text": "UPDATED: This has been reviewed and approved for deployment"
  }
}
```

## DELETE /api/actions/{actionId}

### Description
Deletes a comment action (only works for comment-type actions).

### Method
DELETE

### Endpoint
/api/actions/{actionId}

### Parameters
#### Path Parameters
- **actionId** (string) - Required - The ID of the action to delete.

### Response
#### Success Response (200)
- **_value** (null) - Indicates successful deletion.

#### Response Example
```json
{
  "_value": null
}
```

## GET /api/actions/{actionId}/reactions

### Description
Retrieves emoji reactions on an action with optional member and emoji details.

### Method
GET

### Endpoint
/api/actions/{actionId}/reactions

### Query Parameters
- **member** (boolean) - Optional - Whether to include member information for each reaction.
- **emoji** (boolean) - Optional - Whether to include emoji details for each reaction.

### Parameters
#### Path Parameters
- **actionId** (string) - Required - The ID of the action to retrieve reactions for.

### Response
#### Success Response (200)
- **array** (array) - An array of reaction objects.
  - **id** (string) - The ID of the reaction.
  - **emoji** (object) - Details about the emoji used for the reaction.
    - **unified** (string) - The Unicode unified code for the emoji.
    - **name** (string) - The name of the emoji.
  - **member** (object) - Information about the member who added the reaction.
    - **id** (string) - The ID of the member.
    - **fullName** (string) - The full name of the member.

#### Response Example
```json
[
  {
    "id": "reaction1",
    "emoji": {"unified": "1f44d", "name": "thumbsup"},
    "member": {"id": "member1", "fullName": "John Doe"}
  },
  {
    "id": "reaction2",
    "emoji": {"unified": "1f389", "name": "tada"},
    "member": {"id": "member2", "fullName": "Jane Smith"}
  }
]
```
```

--------------------------------

### Tool: update-list

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Updates list properties including name, position, closed status, and subscription.

```APIDOC
## Tool: update-list

### Description
Updates list properties including name, position, closed status, and subscription.

### Method
POST

### Endpoint
/tools/update-list

### Parameters
#### Request Body
- **listId** (string) - Required - The ID of the list to update.
- **name** (string) - Optional - The new name for the list.
- **pos** (string|integer) - Optional - The new position for the list ('top', 'bottom', or a numeric position).
- **closed** (boolean) - Optional - The new closed status for the list.
- **subscribed** (boolean) - Optional - The new subscription status for the list.

### Request Example
```json
{
  "listId": "list123",
  "name": "Sprint 5 - Active",
  "pos": "bottom",
  "subscribed": true
}
```

### Response
#### Success Response (200)
- **id** (string) - The ID of the updated list.
- **name** (string) - The updated name of the list.
- **closed** (boolean) - The updated closed status of the list.
- **subscribed** (boolean) - The updated subscription status of the list.

### Response Example
```json
{
  "id": "list123",
  "name": "Sprint 5 - Active",
  "closed": false,
  "subscribed": true
}
```
```

--------------------------------

### Move Trello List to Another Board

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Use this tool to migrate a Trello list from its current board to a different one. Ensure you have the correct list and target board IDs.

```typescript
await server.callTool("move-list-to-board", {
  listId: "list123",
  boardId: "targetBoardId456"
});
```

--------------------------------

### Move Multiple Trello Cards in Batch

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Efficiently moves several Trello cards to different lists in a single operation. Specify the card ID, destination list, and optional position for each card.

```typescript
await server.callTool("move-cards", {
  cards: [
    {cardId: "card1", listId: "inProgressList", position: "top"},
    {cardId: "card2", listId: "reviewList", position: "bottom"},
    {cardId: "card3", listId: "doneList"}
  ]
});
```

--------------------------------

### add-comments

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Adds comments to multiple cards in a single batch operation.

```APIDOC
## POST /api/add-comments

### Description
Adds comments to multiple cards in a single batch operation.

### Method
POST

### Endpoint
/api/add-comments

### Parameters
#### Request Body
- **comments** (array) - Required - An array of comment objects.
  - **cardId** (string) - Required - The ID of the card.
  - **text** (string) - Required - The content of the comment.

### Request Example
```json
{
  "comments": [
    {"cardId": "card1", "text": "Sprint planning: moved to Sprint 5"},
    {"cardId": "card2", "text": "Blocked by card1 - dependencies not ready"},
    {"cardId": "card3", "text": "Completed and deployed to staging"}
  ]
}
```

### Response
#### Success Response (200)
- Returns an array of created comment actions.
  - **id** (string) - The ID of the created comment.
  - **data** (object) - Contains the comment details.
    - **text** (string) - The content of the comment.

#### Response Example
```json
[
  {"id": "comment1", "data": {"text": "Sprint planning: moved to Sprint 5", ...}},
  {"id": "comment2", "data": {"text": "Blocked by card1 - dependencies not ready", ...}},
  {"id": "comment3", "data": {"text": "Completed and deployed to staging", ...}}
]
```
```

--------------------------------

### Tool: archive-list

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Archives or unarchives a list by setting its closed status.

```APIDOC
## Tool: archive-list

### Description
Archives or unarchives a list by setting its closed status.

### Method
POST

### Endpoint
/tools/archive-list

### Parameters
#### Request Body
- **listId** (string) - Required - The ID of the list to archive or unarchive.
- **archived** (boolean) - Required - Set to `true` to archive, `false` to unarchive.

### Request Example
```json
{
  "listId": "list123",
  "archived": true
}
```

### Response
#### Success Response (200)
- **id** (string) - The ID of the list.
- **closed** (boolean) - The updated closed status of the list.

### Response Example
```json
{
  "id": "list123",
  "closed": true
}
```
```

--------------------------------

### Retrieve tickets by list

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Fetches cards from a specific list, optimized for ticket workflows.

```typescript
await server.callTool("get-tickets-by-list", {
  listId: "list123",
  limit: 50
});

// Response
[
  {"id": "card1", "name": "Bug: Login fails on mobile", ...},
  {"id": "card2", "name": "Feature: Add dark mode", ...}
]
```

--------------------------------

### archive-cards

Source: https://context7.com/adriangrahldev/advanced-trello-mcp-server/llms.txt

Archives multiple cards in a single batch operation.

```APIDOC
## POST /api/archive-cards

### Description
Archives multiple cards in a single batch operation.

### Method
POST

### Endpoint
/api/archive-cards

### Parameters
#### Request Body
- **cardIds** (array) - Required - An array of card IDs to archive.
  - **cardId** (string) - Required - The ID of the card to archive.

### Request Example
```json
{
  "cardIds": ["card1", "card2", "card3", "card4"]
}
```

### Response
#### Success Response (200)
- Returns an array of archived card objects.
  - **id** (string) - The ID of the archived card.
  - **closed** (boolean) - Indicates if the card is archived (true).

#### Response Example
```json
[
  {"id": "card1", "closed": true},
  {"id": "card2", "closed": true},
  {"id": "card3", "closed": true},
  {"id": "card4", "closed": true}
]
```
```