AgilePlace

You can run an MCP server that exposes AgilePlace data and actions, letting you manage boards, cards, OKRs, activities, and projects through a consistent API layer. This server lets you integrate AgilePlace capabilities into your own tools and automations with structured, programmable access.

How to use

Start the server to enable MCP endpoints you can consume from your client. Run the server, then use your MCP client to list boards, manage cards, connect OKRs to work items, and perform bulk operations. You can also query objects by board, connect activities to key results, and list projects with filtering.

How to install

pip install -r requirements.txt

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

python -m agileplace_mcp.server

Configuration and usage notes

Set up credentials and run-time options to customize how the MCP server talks to AgilePlace and the OKRs API. The required environment variables above enable authentication and enable OKR-related features. If you only want core board and card management, you can omit OKR-related settings.

Security and maintenance

Keep your API tokens secret and rotate them periodically. Use network access controls to restrict who can reach the MCP server, and consider placing the server behind a reverse proxy with TLS termination for encrypted client communication.

Troubleshooting tips

If the server does not start, verify that Python is available, dependencies install cleanly, and the provided environment variables are exported in your shell. Check for common issues like missing tokens or incorrect domain values.

Available tools

list_boards

List all boards accessible to the configured user.

get_board

Get detailed information about a specific board, including lanes, card types, and custom fields.

get_board_cards

Retrieve cards on a board, with optional filtering.

get_leaf_lanes

Get lanes that can hold cards (leaf lanes).

create_board

Create a new board with specified attributes.

get_board_members

Fetch members assigned to a board.

list_cards

List cards with optional filters such as board, lane, or status.

get_card

Get detailed information about a specific card.

get_card_activity

Retrieve the activity history for a card.

create_card

Create a new card on a board and lane.

update_card

Update fields on an existing card.

move_card

Move a card to a different lane.

delete_card

Delete a card from the board.

get_card_comments

Fetch comments associated with a card.

create_comment

Add a comment to a card.

assign_users_to_card

Assign users or teams to a card.

get_card_children

Retrieve child cards connected to a card.

get_card_parents

Retrieve parent cards connected to a card.

create_connection

Create a parent-child connection between cards.

delete_connection

Remove a card connection.

get_connection_statistics

Get statistics about card connections.

connect_cards_bulk

Create multiple connections in a single operation.

get_card_dependencies

Fetch dependencies for a card.

create_dependency

Create dependencies between cards.

delete_dependency

Delete card dependencies.

update_cards_bulk

Update multiple cards in a single operation.

delete_cards_bulk

Delete multiple cards in a single operation.

move_cards_bulk

Move multiple cards between lanes.

assign_members_bulk

Assign members to multiple boards in bulk.

create_objective

Create a new OKR Objective.

create_key_result

Create a new Key Result.

update_objective

Update an OKR Objective.

update_key_result

Update a Key Result.

get_objectives_by_board_id

Get Objectives associated with a specific board.

get_key_results_by_objective_id

Get Key Results for a specific Objective.

connect_activities_to_key_result

Connect work items to a Key Result as activities.

create_activity

Create activities linked to a Key Result.

list_activities

List activities with optional filtering.

list_activity_containers

List containers that organize activities.

search_activities

Search for activities by criteria.

list_activity_types

List available activity types.

search_users

Search users within contexts.

get_current_user

Get information about the currently authenticated user.

list_projects

List projects with optional filtering.

get_project_attributes

Get attributes for projects.

get_work_attributes

Get attributes for work items.