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
pip install -r requirements.txt
Configuration
Set up your AgilePlace API credentials:
export AGILEPLACE_DOMAIN="your-subdomain.leankit.com"
export AGILEPLACE_API_TOKEN="your-api-token"
export OKRS_API_BASE_URL="https://api.pv-platforma.xyz/api" # Optional, for OKR features
Usage
Running the Server
python -m agileplace_mcp.server
Available Tools
Board Tools
list_boards: List all accessible boardsget_board: Get detailed board informationget_board_cards: Get cards on a boardget_leaf_lanes: Get lanes that can hold cardscreate_board: Create a new boardget_board_members: Get board members
Card Tools
list_cards: List cards with optional filteringget_card: Get detailed card informationget_card_activity: Get card activity historycreate_card: Create a new cardupdate_card: Update card fieldsmove_card: Move a card to a different lanedelete_card: Delete a cardget_card_comments: Get card commentscreate_comment: Add a comment to a cardassign_users_to_card: Assign users/teams to a cardget_card_children: Get child cardsget_card_parents: Get parent cards
Connection Tools
create_connection: Create parent-child card connectionsdelete_connection: Remove card connectionsget_connection_statistics: Get connection statisticsconnect_cards_bulk: Create multiple connections
Dependency Tools
get_card_dependencies: Get card dependenciescreate_dependency: Create card dependenciesdelete_dependency: Delete dependencies
Bulk Operation Tools
update_cards_bulk: Update multiple cardsdelete_cards_bulk: Delete multiple cardsmove_cards_bulk: Move multiple cardsassign_members_bulk: Assign members to multiple boards
OKR Tools
create_objective: Create a new OKR Objectivecreate_key_result: Create a new Key Resultupdate_objective: Update an Objectiveupdate_key_result: Update a Key Resultget_objectives_by_board_id: Get Objectives for a boardget_key_results_by_objective_id: Get Key Results for an Objective
OKR Activity Tools
connect_activities_to_key_result: Connect work items to Key Resultscreate_activity: Create activities for Key Resultslist_activities: List activities with filteringlist_activity_containers: List activity containerssearch_activities: Search activitieslist_activity_types: List available activity typessearch_users: Search usersget_current_user: Get current user information
Query Tools
list_projects: List projects with filteringget_project_attributes: Get project attributesget_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
agileplace_mcp/
├── agileplace_mcp/
│ ├── __init__.py
│ ├── auth.py # Authentication handling
│ ├── client.py # API client
│ ├── models.py # Data models
│ ├── server.py # FastMCP server
│ └── tools/
│ ├── __init__.py
│ ├── boards.py # Board operations
│ ├── bulk.py # Bulk operations
│ ├── cards.py # Card operations
│ ├── connections.py # Connection operations
│ ├── dependencies.py # Dependency operations
│ ├── okr.py # OKR operations
│ ├── okr_activities.py # OKR activity operations
│ └── query.py # Query operations
├── requirements.txt
├── README.md
└── server.py
Adding New Tools
- Create the function in the appropriate
tools/*.pyfile - Add the corresponding MCP tool wrapper in
server.py - Update data models in
models.pyif needed - Add tests in the
tests/directory
Testing
python -m pytest tests/
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Submit a pull request
License
This project is licensed under the MIT License.