# 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

```bash
pip install -r requirements.txt
```

## Configuration

Set up your AgilePlace API credentials:

```bash
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

```bash
python -m agileplace_mcp.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

```
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

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

```bash
python -m pytest tests/
```

## 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.