### Example Success Response for update-checkitem

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

A JSON example of a successful response from the `update-checkitem` tool, showing updated checkitem details, changes made, and relevant IDs.

```json
{
  "success": true,
  "message": "Checkitem \"Updated task description\" updated successfully",
  "checkitemId": "8b9c1d2e3f4a5b6c7d8e9f1a",
  "checkitemName": "Updated task description",
  "cardId": "7a8b9c1d2e3f4a5b6c7d8e9f",
  "state": "complete",
  "position": 16384,
  "checklistId": "9c1d2e3f4a5b6c7d8e9f1a2b",
  "changes": [
    "name updated to \"Updated task description\"",
    "state changed to \"complete\"",
    "position changed to 16384"
  ],
  "updatedCheckitem": {
    "id": "8b9c1d2e3f4a5b6c7d8e9f1a",
    "name": "Updated task description",
    "state": "complete",
    "pos": 16384,
    "due": null,
    "dueReminder": null,
    "idMember": null,
    "idChecklist": "9c1d2e3f4a5b6c7d8e9f1a2b",
    "idCard": "7a8b9c1d2e3f4a5b6c7d8e9f"
  }
}
```

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

### Example Error Response for update-checkitem

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

A JSON example of an error response from the `update-checkitem` tool, indicating a failure, an error message, and a suggestion for resolution.

```json
{
  "success": false,
  "error": "Checkitem not found",
  "message": "The specified checkitem ID does not exist on the specified card or you don't have access to it.",
  "suggestion": "Use get-checklists-for-card tool to find valid checkitem IDs."
}
```

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

### Initialize and Use Trello API Service Directly

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Demonstrates how to get an instance of `TrelloApiService`, initialize it to validate credentials, and then make various API calls to retrieve user boards, current user info, or custom data.

```typescript
import { TrelloApiService } from "./services/trello-api.js";

// Get service instance
const trelloService = TrelloApiService.getInstance();

// Initialize (validates credentials)
await trelloService.initialize();

// Get user's boards
const boards = await trelloService.getUserBoards();

// Get current user info
const user = await trelloService.getCurrentUser();

// Make custom API calls
const customData = await trelloService.get("/members/me/cards");
```

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

### JSON: Example Success Response for update-card Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

A sample JSON response demonstrating a successful update operation using the `update-card` tool, including the updated card details and a summary of changes.

```json
{
  "success": true,
  "message": "Card \"Updated Task Name\" updated successfully",
  "cardId": "7a8b9c1d2e3f4a5b6c7d8e9f",
  "cardName": "Updated Task Name",
  "cardUrl": "https://trello.com/c/shorturl",
  "changes": [
    "name updated to \"Updated Task Name\"",
    "moved to list 5f7b8c9d1e2f3a4b5c6d7e8f",
    "position changed to top"
  ],
  "updatedCard": {
    "id": "7a8b9c1d2e3f4a5b6c7d8e9f",
    "name": "Updated Task Name",
    "desc": "Task description",
    "closed": false,
    "pos": 16384,
    "idList": "5f7b8c9d1e2f3a4b5c6d7e8f",
    "idBoard": "6f8c9d1e2f3a4b5c6d7e8f9a",
    "due": null,
    "dueComplete": false,
    "idMembers": [],
    "labels": [],
    "url": "https://trello.com/c/shorturl",
    "dateLastActivity": "2025-05-29T12:00:00.000Z"
  }
}
```

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

### JSON: Example Error Response for update-card Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

A sample JSON response illustrating an error scenario when using the `update-card` tool, providing an error message and a suggestion for resolution.

```json
{
  "success": false,
  "error": "Card not found",
  "message": "The specified card ID does not exist or you don't have access to it.",
  "suggestion": "Use get-all-cards-for-each-list or get-cards-for-list tools to find valid card IDs."
}
```

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

### Build and Run Trello API Helper Service

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Commands to compile the Trello API Helper Service and then execute the compiled JavaScript file, initiating the service.

```bash
npm run build
node build/index.js
```

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

### Tool: Move Trello Card to Different List

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Example showing how to move a Trello card to another list and specify its position within that list using the `update-card` tool.

```Tool
Tool: update-card
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
  idList: "5f7b8c9d1e2f3a4b5c6d7e8f"
  pos: "top"
```

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

### Configure Trello API Environment Variables

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Instructions to set up environment variables for Trello API key and token by creating a .env file, essential for authenticating requests to the Trello API.

```bash
TRELLO_API_KEY=your_actual_api_key_here
TRELLO_TOKEN=your_actual_token_here
```

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

### Install Trello MCP Server Dependencies

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This command installs all necessary Node.js dependencies for the Trello MCP server. It should be run after cloning the repository to prepare the project for building and execution.

```bash
npm install
```

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

### Create Trello Checklist using MCP Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

This section details the `create-checklist` tool, which allows users to add new checklists to Trello cards. It explains the required `cardId` parameter, optional `name` and `pos` parameters, and provides examples for basic and named checklist creation. Success and error response formats are also included.

```APIDOC
Tool: create-checklist
Description: Creates a new checklist for a specific Trello card with optional name and position.
Parameters:
  cardId (required): The ID of the Trello card to add the checklist to (24-character hexadecimal string)
  name (optional): Name for the new checklist (defaults to "Checklist" if not provided)
  pos (optional): Position of the checklist. Use 'top', 'bottom', or a positive number
Returns:
  Created checklist information with complete details
  Success/failure status with detailed error messages
  Suggestions for resolving errors when they occur
```

```APIDOC
Tool: create-checklist
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
```

```APIDOC
Tool: create-checklist
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
  name: "Project Tasks"
  pos: "top"
```

```json
{
  "success": true,
  "message": "Checklist \"Project Tasks\" created successfully",
  "checklistId": "8b9c1d2e3f4a5b6c7d8e9f1a",
  "checklistName": "Project Tasks",
  "cardId": "7a8b9c1d2e3f4a5b6c7d8e9f",
  "position": 16384,
  "checklist": {
    "id": "8b9c1d2e3f4a5b6c7d8e9f1a",
    "name": "Project Tasks",
    "idCard": "7a8b9c1d2e3f4a5b6c7d8e9f",
    "idBoard": "6f8c9d1e2f3a4b5c6d7e8f9a",
    "pos": 16384,
    "checkItems": []
  }
}
```

```json
{
  "success": false,
  "error": "Card not found",
  "message": "The specified card ID does not exist or you don't have access to it.",
  "suggestion": "Use get-all-cards-for-each-list or get-cards-for-list tools to find valid card IDs."
}
```

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

### TrelloApiService Class Overview

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Documentation for the TrelloApiService, the core class managing all Trello API interactions. It implements a singleton pattern, handles automatic authentication, provides robust error handling, and supports various HTTP methods (GET, POST, PUT, DELETE).

```APIDOC
TrelloApiService:
  - Singleton Pattern: Ensures consistent credential management
  - Automatic Authentication: Injects API key and token into all requests
  - Error Handling: Provides user-friendly error messages without exposing credentials
  - Multiple HTTP Methods: Supports GET, POST, PUT, DELETE operations
```

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

### Tool: Set Trello Card Due Date and Assign Members

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Example illustrating how to update a Trello card's due date and assign multiple members simultaneously using the `update-card` tool.

```Tool
Tool: update-card
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
  due: "2025-06-15T17:00:00.000Z"
  idMembers: ["1a2b3c4d5e6f7a8b9c1d2e3f", "2b3c4d5e6f7a8b9c1d2e3f4a"]
```

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

### Tool: Update Trello Card Name

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Example demonstrating how to use the `update-card` tool to change the name of a specific Trello card by providing its ID and the new name.

```Tool
Tool: update-card
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
  name: "Updated Task Name"
```

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

### Create New Trello Tool with TrelloApiService

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Shows how to define a new tool that integrates with the `TrelloApiService`, including checking for service initialization, making API calls, and handling potential errors within the tool's handler function.

```typescript
import { TrelloApiService } from "../services/trello-api.js";

const myTool: ToolDefinition = {
  name: "my-trello-tool",
  description: "My custom Trello tool",
  params: {},
  handler: async () => {
    try {
      const trelloService = TrelloApiService.getInstance();

      // Service will auto-initialize if needed
      if (!trelloService.isServiceInitialized()) {
        await trelloService.initialize();
      }

      // Use the service
      const data = await trelloService.get("/some/endpoint");

      return {
        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
      };
    } catch (error) {
      // Handle errors appropriately
      return {
        content: [{ type: "text", text: `Error: ${error.message}` }],
      };
    }
  },
};
```

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

### about-me Tool API Reference

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

API documentation for the 'about-me' tool, a test utility that fetches the authenticated user's Trello boards. It demonstrates basic Trello API integration and returns a list of boards with their status, organization info, URLs, and descriptions.

```APIDOC
Tool: about-me
Usage: Call the about-me tool through your MCP client
Returns:
  - List of user's Trello boards
  - Board status (open/closed)
  - Organization information (if applicable)
  - Board URLs and descriptions
```

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

### Retrieve Trello Checklists for Card using MCP Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

This section describes the `get-checklists-for-card` tool, which fetches all checklists associated with a given Trello card ID. It outlines the required `cardId` parameter and provides an example usage and a detailed success response format. Error responses are similar to the `create-checklist` tool.

```APIDOC
Tool: get-checklists-for-card
Description: Gets all checklists for a specific Trello card by providing the card ID.
Parameters:
  cardId (required): The ID of the Trello card to get checklists from (24-character hexadecimal string)
Returns:
  List of all checklists associated with the card
  Progress information for each checklist (completed/total items)
  Detailed information about each checklist item
  Clear indication if no checklists exist for the card
```

```APIDOC
Tool: get-checklists-for-card
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
```

```plaintext
# Checklists for Card

**Card ID:** 7a8b9c1d2e3f4a5b6c7d8e9f
**Total Checklists:** 2

## Checklists

### 1. Project Setup

**Checklist ID:** 8b9c1d2e3f4a5b6c7d8e9f1a
**Position:** 16384
**Progress:** 2/3 items completed (67%)

**Items:**
1. ✅ Create repository
2. ✅ Setup development environment  
3. ⏹️ Write initial documentation

### 2. Testing Tasks

**Checklist ID:** 9c1d2e3f4a5b6c7d8e9f1a2b
**Position:** 32768
**Progress:** 0/2 items completed (0%)

**Items:**
1. ⏹️ Write unit tests
2. ⏹️ Setup CI/CD pipeline
```

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

### list-my-boards Tool API Reference

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

API documentation for the 'list-my-boards' tool, which retrieves all Trello boards accessible to the authenticated user. It provides comprehensive details including board IDs, names, URLs, and status.

```APIDOC
Tool: list-my-boards
Usage: Call the list-my-boards tool through your MCP client
Returns:
  - Complete list of accessible boards
  - Board IDs, names, and URLs
  - Board status (open/closed)
```

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

### Mark Trello Checkitem as Complete

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Demonstrates how to use the `update-checkitem` tool to change a checkitem's state to 'complete' on a specified Trello card.

```APIDOC
Tool: update-checkitem
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
  checkitemId: "8b9c1d2e3f4a5b6c7d8e9f1a"
  state: "complete"
```

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

### Tool: Move Trello Card Between Lists (Common Pattern)

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Common pattern for moving a Trello card to a new list and specifying its position using the `update-card` tool.

```Tool
Parameters: { cardId: "...", idList: "new_list_id", pos: "bottom" }
```

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

### Tool: Update Trello Card with Due Date (Common Pattern)

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Common pattern for setting a Trello card's due date and marking its completion status using the `update-card` tool.

```Tool
Parameters: { cardId: "...", due: "2025-06-30T23:59:59.000Z", dueComplete: false }
```

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

### APIDOC: update-card Tool Parameters and Returns

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Detailed API documentation for the `update-card` tool, outlining all supported parameters for modifying Trello card properties and describing the structure of its successful and error responses.

```APIDOC
update-card Tool:
  Description: Updates Trello card details with comprehensive parameter support and validation. Supports partial updates - only provided parameters will be modified.
  Usage: Call the `update-card` tool through your MCP client

  Parameters:
    cardId (required): The ID of the Trello card to update (24-character hexadecimal string)
    name (optional): New name for the card
    desc (optional): New description for the card
    closed (optional): Whether to archive (true) or unarchive (false) the card
    idList (optional): ID of the list to move the card to (24-character hexadecimal string)
    idBoard (optional): ID of the board to move the card to (24-character hexadecimal string)
    pos (optional): Position of the card in the list. Use 'top', 'bottom', or a positive number
    due (optional): Due date for the card in ISO 8601 format (e.g., '2023-12-31T23:59:59.000Z')
    start (optional): Start date for the card in ISO 8601 format (e.g., '2023-12-31T00:00:00.000Z')
    dueComplete (optional): Whether the due date has been completed
    idMembers (optional): Array of member IDs to assign to the card (24-character hexadecimal strings)
    idLabels (optional): Array of label IDs to assign to the card (24-character hexadecimal strings)

  Returns:
    Updated card information with complete details
    Summary of changes made
    Success/failure status with detailed error messages
    Suggestions for resolving errors when they occur
```

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

### Move Trello Checkitem to Different Checklist

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Illustrates how to move a checkitem from its current checklist to another specified checklist using the `update-checkitem` tool.

```APIDOC
Tool: update-checkitem
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
  checkitemId: "8b9c1d2e3f4a5b6c7d8e9f1a"
  idChecklist: "9c1d2e3f4a5b6c7d8e9f1a2b"
```

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

### Rename and Reposition Trello Checkitem

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Shows how to update a checkitem's name and position (e.g., to the top of its list) using the `update-checkitem` tool.

```APIDOC
Tool: update-checkitem
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
  checkitemId: "8b9c1d2e3f4a5b6c7d8e9f1a"
  name: "Updated task description"
  pos: "top"
```

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

### Tool: Archive a Trello Card

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Common pattern for archiving a Trello card by setting its `closed` parameter to true using the `update-card` tool.

```Tool
Parameters: { cardId: "...", closed: true }
```

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

### Common Trello Checkitem Update Patterns

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Provides common parameter patterns for updating Trello checkitems using the `update-checkitem` tool, including marking complete, renaming, repositioning, and moving to a different checklist.

```APIDOC
Parameters: { cardId: "...", checkitemId: "...", state: "complete" }
```

```APIDOC
Parameters: { cardId: "...", checkitemId: "...", name: "New task name" }
```

```APIDOC
Parameters: { cardId: "...", checkitemId: "...", pos: "top" }
```

```APIDOC
Parameters: { cardId: "...", checkitemId: "...", idChecklist: "new_checklist_id" }
```

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

### Tool: Bulk Update Trello Card Properties (Common Pattern)

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Common pattern for performing a bulk update on multiple Trello card properties, including name, description, members, and labels, using the `update-card` tool.

```Tool
Parameters: {
  cardId: "...",
  name: "New Name",
  desc: "New Description",
  idMembers: ["member1", "member2"],
  idLabels: ["label1", "label2"]
}
```

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

### APIDOC: `about-me` Trello Boards Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This tool retrieves and displays the authenticated user's Trello boards. It serves as a test tool to validate the Trello API setup and ensure proper connectivity and authentication.

```APIDOC
`about-me`
  Usage: Call through your MCP client
  Returns: List of your Trello boards with details
```

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

### update-checkitem Tool API Reference

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

Details the `update-checkitem` tool, its required and optional parameters for modifying Trello checkitems, and the structure of its return values, including success/failure status and error suggestions.

```APIDOC
Tool: update-checkitem
Description: Updates a checkitem on a Trello card with support for changing name, state, position, and moving between checklists.

Parameters:
- cardId (required): The ID of the Trello card containing the checkitem (24-character hexadecimal string)
- checkitemId (required): The ID of the checkitem to update (24-character hexadecimal string)
- name (optional): New name for the checkitem
- state (optional): State of the checkitem ('complete' or 'incomplete')
- idChecklist (optional): ID of the checklist to move the checkitem to (24-character hexadecimal string)
- pos (optional): Position of the checkitem. Use 'top', 'bottom', or a positive number

Returns:
- Updated checkitem information with complete details
- Summary of changes made
- Success/failure status with detailed error messages
- Suggestions for resolving errors when they occur
```

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

### get-card Tool API Reference

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

API documentation for the 'get-card' tool, which retrieves detailed information about a specific Trello card using its ID. It provides comprehensive card properties, metadata, board and list context, status, timestamps, and direct links.

```APIDOC
Tool: get-card
Usage: Call the get-card tool through your MCP client
Parameters:
  cardId (required): The ID of the Trello card to retrieve
Returns:
  - Comprehensive card details including all properties and metadata
  - Board and list context information
  - Card status, position, and timestamps
  - Description, due dates, labels, and assigned members
  - Direct links and IDs for further operations

Example Usage:
Tool: get-card
Parameters:
  cardId: "7a8b9c1d2e3f4a5b6c7d8e9f"
```

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

### get-cards-for-list Tool API Reference

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

API documentation for the 'get-cards-for-list' tool, which retrieves all cards for a specific Trello list using its ID. It provides comprehensive card details, list information, and last activity dates for each card.

```APIDOC
Tool: get-cards-for-list
Usage: Call the get-cards-for-list tool through your MCP client
Parameters:
  listId (required): The ID of the Trello list to fetch cards from
Returns:
  - All cards in the specified list
  - Card details including ID, name, URL, description, due dates, labels, members
  - List information and status
  - Last activity dates for each card

Example Usage:
Tool: get-cards-for-list
Parameters:
  listId: "5f7b8c9d1e2f3a4b5c6d7e8f"

Example Output Structure:
# Cards in List: To Do

**List ID:** 5f7b8c9d1e2f3a4b5c6d7e8f
**List Status:** Open
**Board ID:** 6f8c9d1e2f3a4b5c6d7e8f9a
**Total Cards:** 3

## Cards

### 1. Task One (Open)
**Card ID:** 7a8b9c1d2e3f4a5b6c7d8e9f
**URL:** [Open Card](https://trello.com/c/shorturl)
**Description:** Complete the first task...
**Due Date:** 05/30/2025 (Pending)
**Labels:** High Priority, Bug
**Members:** 2 assigned
**Last Activity:** 05/29/2025
```

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

### get-board-lists Tool API Reference

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

API documentation for the 'get-board-lists' tool, designed to retrieve all lists from a designated working board. Requires the TRELLO_WORKING_BOARD_ID environment variable to be set. Returns list IDs, names, positions, status, and total count.

```APIDOC
Tool: get-board-lists
Usage: Call the get-board-lists tool through your MCP client
Prerequisites: Set TRELLO_WORKING_BOARD_ID environment variable
Returns:
  - All lists from the working board
  - List IDs, names, positions, and status
  - Total list count
```

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

### get-all-cards-for-each-list Tool API Reference

Source: https://github.com/starside-io/trello-mcp/blob/main/docs/TRELLO_USAGE.md

API documentation for the 'get-all-cards-for-each-list' tool, which fetches all cards for every list on the designated working board, organized by list. Requires the TRELLO_WORKING_BOARD_ID environment variable. Returns detailed card information, list and card counts, and status indicators.

```APIDOC
Tool: get-all-cards-for-each-list
Usage: Call the get-all-cards-for-each-list tool through your MCP client
Prerequisites: Set TRELLO_WORKING_BOARD_ID environment variable
Returns:
  - All cards organized by their containing lists
  - Card details including ID, name, URL, position, labels, due dates
  - Card and list counts
  - Status indicators for both lists and cards

Example Output Structure:
# All Cards by List

**Working Board ID:** 6836b64d461ba344f5a564a2
**Total Lists:** 3
**Total Cards:** 15

## 1. To Do (Open)
**List ID:** 6836b64d461ba344f5a564a3
**Cards:** 5

   1. **Setup project structure** (Open)
      - ID: 6836b64d461ba344f5a564a4
      - URL: https://trello.com/c/abc123
      - Position: 16384
      - Labels: 2
      - Due Date: 2025-06-01T10:00:00.000Z
      - Description: Yes

   2. **Create API endpoints** (Open)
      - ID: 6836b64d461ba344f5a564a5
      - URL: https://trello.com/c/def456
      - Position: 32768
      - Labels: 1
      - Due Date: None
      - Description: No
```

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

### Build and Run Trello MCP Server

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

These commands compile the TypeScript source code into JavaScript and then execute the compiled server. This process makes the MCP server ready to accept client connections and process Trello API requests.

```bash
npm run build
node build/index.js
```

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

### APIDOC: `hello-world` Connectivity Test Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This is a simple greeting tool designed to test basic connectivity with the MCP server. It confirms that the server is running and accessible.

```APIDOC
`hello-world`
  Simple greeting tool for testing MCP server connectivity.
```

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

### Build Trello MCP Project

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This command compiles the Trello MCP server project. It transforms the source code into an executable format, typically JavaScript, preparing it for deployment or execution.

```bash
npm run build
```

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

### Project Contribution Guidelines

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This section outlines the essential guidelines for contributing to the Trello MCP project. It emphasizes following existing patterns, utilizing the TrelloApiService for all Trello API interactions, implementing robust error handling, and maintaining up-to-date documentation for new features.

```Plaintext
1. Follow the existing patterns in `src/tools/` for new tools
2. Use the `TrelloApiService` for all Trello API interactions
3. Include proper error handling and user-friendly messages
4. Update documentation for new features
```

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

### Configure Trello API Credentials in .env

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This snippet shows how to set up environment variables for Trello API key, token, and working board ID. These credentials are essential for the MCP server to authenticate and interact with the Trello API, ensuring secure access to Trello resources.

```bash
TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here
TRELLO_WORKING_BOARD_ID=your_working_board_id_here
```

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

### Configure Trello MCP Server in VS Code Settings

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This JSON snippet demonstrates how to integrate the Trello MCP server into VS Code's settings. It defines a custom MCP server entry, specifying the command to run the server and allowing for environment variable configuration, enabling seamless development workflow.

```json
"mcp": {
  "servers": {
    "trello-mcp": {
      "command": "node",
      "args": ["/path/to/trello-mcp/build/index.js"],
      "env": {}
    }
  }
}
```

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

### Add New Trello MCP Tools

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This section outlines the process for adding new tools to the Trello MCP server. It specifies the file location for new tools, the import requirement, and how to access the Trello API service instance within a tool.

```typescript
1. Create your tool in `src/tools/`
2. Import it in `src/tools/index.ts`
3. Use `TrelloApiService.getInstance()` for Trello API access
```

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

### APIDOC: `list-my-boards` Trello Boards Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This tool lists all Trello boards accessible to the authenticated user. It is primarily used to find the ID of a specific working board for further configuration or operations.

```APIDOC
`list-my-boards`
  Usage: Call through your MCP client
  Returns: Complete list of accessible boards with their IDs, names, and URLs
```

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

### APIDOC: `get-card` Trello Card Details Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This tool retrieves comprehensive details for a specific Trello card. It requires the card ID as a parameter and returns all properties, metadata, labels, members, and due dates associated with that card.

```APIDOC
`get-card`
  Usage: Call through your MCP client with `cardId` parameter
  Parameters: `cardId` (required) - The ID of the Trello card
  Returns: Comprehensive card details including properties, metadata, labels, members, and due dates
```

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

### APIDOC: `random-number` Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This tool generates a random number. It is useful for testing the general execution flow of tools within the MCP server environment.

```APIDOC
`random-number`
  Generates a random number - useful for testing tool execution.
```

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

### APIDOC: `get-cards-for-list` Trello List Cards Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This tool retrieves all cards associated with a specific Trello list. It requires the list ID as a parameter to fetch detailed information about all cards within that list.

```APIDOC
`get-cards-for-list`
  Usage: Call through your MCP client with `listId` parameter
  Parameters: `listId` (required) - The ID of the Trello list
  Returns: All cards in the specified list with detailed information
```

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

### APIDOC: `update-card` Trello Card Update Tool

Source: https://github.com/starside-io/trello-mcp/blob/main/README.md

This tool updates details of a specific Trello card, supporting partial updates for various properties like name, description, due dates, and assignments. Only provided parameters will be modified, allowing flexible updates.

```APIDOC
`update-card`
  Usage: Call through your MCP client with `cardId` and optional update parameters
  Parameters:
    `cardId` (required) - The ID of the Trello card to update
    `name` (optional) - New name for the card
    `desc` (optional) - New description for the card
    `closed` (optional) - Whether to archive (true) or unarchive (false) the card
    `idList` (optional) - ID of the list to move the card to
    `idBoard` (optional) - ID of the board to move the card to
    `pos` (optional) - Position in the list ('top', 'bottom', or number)
    `due` (optional) - Due date in ISO 8601 format
    `start` (optional) - Start date in ISO 8601 format
    `dueComplete` (optional) - Whether the due date has been completed
    `idMembers` (optional) - Array of member IDs to assign to the card
    `idLabels` (optional) - Array of label IDs to assign to the card
  Returns: Updated card information with change summary
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.