AgilePlace MCP Server

A Model Context Protocol (MCP) server for integrating with AgilePlace project management platform.

Features

Board Management

• List, create, and view boards

• Get board details including lanes, card types, and custom fields

• Manage board members

Card Management

• Create, read, update, and delete cards

• Move cards between lanes

• Add comments to cards

• Assign users and teams to cards

• Manage card connections (parent-child relationships)

• Manage card dependencies

Bulk Operations

• Update multiple cards simultaneously

• Delete multiple cards in bulk

• Move multiple cards between lanes

• Assign members to multiple boards

OKR Management (Objectives and Key Results)

• Create and manage OKR Objectives

• Create and manage Key Results

• Update Objectives and Key Results

• Query Objectives by board

• Query Key Results by Objective

OKR Activity and Work Item Management

• Connect work items (cards) to Key Results

• Create activities associated with Key Results

• List and search activities

• List activity containers

• List available activity types

• Search users within contexts

Project Management

• List projects with filtering

• Get project and work attributes

Installation

Configuration

Set up your AgilePlace API credentials:

Usage

Running the Server

Available Tools

Board Tools

• list_boards: List all accessible boards

• get_board: Get detailed board information

• get_board_cards: Get cards on a board

• get_leaf_lanes: Get lanes that can hold cards

• create_board: Create a new board

• get_board_members: Get board members

Card Tools

• list_cards: List cards with optional filtering

• get_card: Get detailed card information

• get_card_activity: Get card activity history

• create_card: Create a new card

• update_card: Update card fields

• move_card: Move a card to a different lane

• delete_card: Delete a card

• get_card_comments: Get card comments

• create_comment: Add a comment to a card

• assign_users_to_card: Assign users/teams to a card

• get_card_children: Get child cards

• get_card_parents: Get parent cards

Connection Tools

• create_connection: Create parent-child card connections

• delete_connection: Remove card connections

• get_connection_statistics: Get connection statistics

• connect_cards_bulk: Create multiple connections

Dependency Tools

• get_card_dependencies: Get card dependencies

• create_dependency: Create card dependencies

• delete_dependency: Delete dependencies

Bulk Operation Tools

• update_cards_bulk: Update multiple cards

• delete_cards_bulk: Delete multiple cards

• move_cards_bulk: Move multiple cards

• assign_members_bulk: Assign members to multiple boards

OKR Tools

• create_objective: Create a new OKR Objective

• create_key_result: Create a new Key Result

• update_objective: Update an Objective

• update_key_result: Update a Key Result

• get_objectives_by_board_id: Get Objectives for a board

• get_key_results_by_objective_id: Get Key Results for an Objective

OKR Activity Tools

• connect_activities_to_key_result: Connect work items to Key Results

• create_activity: Create activities for Key Results

• list_activities: List activities with filtering

• list_activity_containers: List activity containers

• search_activities: Search activities

• list_activity_types: List available activity types

• search_users: Search users

• get_current_user: Get current user information

Query Tools

• list_projects: List projects with filtering

• get_project_attributes: Get project attributes

• get_work_attributes: Get work attributes

API Documentation

The server integrates with the following AgilePlace APIs:

• Board API

• Card API

• Connection API

• Dependency API

• OKR API

• Activity API

• Project API

Development

Project Structure

Adding New Tools

1. Create the function in the appropriate tools/*.py file

2. Add the corresponding MCP tool wrapper in server.py

3. Update data models in models.py if needed

4. Add tests in the tests/ directory

Testing

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests for new functionality

5. Submit a pull request

License

This project is licensed under the MIT License.