# Leiga MCP MCP

> Leiga MCP manages agile project lifecycles by letting your AI agent interact directly with the Leiga platform. This connector handles everything from listing active projects and inspecting their full details, to creating new tasks and tracking team workload capacity in real time. You can list all configured teams or browse existing sprints with built-in velocity data—it's designed for continuous project oversight without leaving your chat window.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** agile-management, sprint-planning, task-tracking, workload-balancing, team-collaboration, ai-assisted-planning

## Description

Need to keep up with multiple projects, tasks, and who is doing what? This MCP lets you talk to Leiga like it’s just another tool in the stack. Instead of logging into a dashboard and clicking through five different tabs just to get a status update, you ask your agent directly: 'What's the status of Mobile App?' It pulls that data instantly. You can use natural language conversations to list all active projects, drill down on specific task assignments, or check team member availability before assigning work. The whole thing works via Vinkius, giving you access to Leiga’s full set of tools right alongside your other services. This isn't just reading data; it lets you run structured queries—like finding out if Sarah has capacity for a new assignment—and even create those tasks directly. It cuts down the friction between knowing something needs doing and actually documenting it.

## Tools

### create_task
Adds a new item to the project backlog with necessary details like priority and assignment.

### get_project_details
Retrieves all metadata for one specific Leiga project ID.

### get_task_details
Fetches the full status, assignee, and description for a single task.

### list_team_members
Shows a roster of all user accounts currently configured in your Leiga workspace.

### list_projects
Retrieves the names and basic status for every project configured in Leiga.

### list_tasks
Lists multiple tasks, letting you filter the results by a specific project ID or date range.

### list_organizational_teams
Provides a list of all structured teams within your organization.

### list_workflows
Lists any automated workflows set up to trigger actions based on project events.

## Prompt Examples

**Prompt:** 
```
Show all projects and the current sprint status.
```

**Response:** 
```
Projects: 4. 'Platform v2' (45 tasks), 'Mobile App' (28), 'API Redesign' (18), 'DevOps' (12). Current sprint (Sprint 14): 18 tasks. Done: 8 (44%), In Progress: 6, To Do: 4. Velocity: 22 pts/sprint (avg). Capacity: 85% utilized. Deadline: Apr 30. ⚠️ 2 tasks blocked.
```

**Prompt:** 
```
Create a task 'Fix auth bug' and show team workload.
```

**Response:** 
```
Task created! 'Fix auth bug' — Priority: High, Sprint 14, Assigned: Sarah. Team: Sarah (6 tasks, 90% ⚠️), Mike (4 tasks, 65%), Lisa (5 tasks, 75%), James (3 tasks, 50%). Sprint points: 22/26 allocated. Sarah at capacity — consider reassigning.
```

**Prompt:** 
```
Show sprint velocity trends and blocked tasks.
```

**Response:** 
```
Velocity (last 5 sprints): S10: 18, S11: 20, S12: 22, S13: 24, S14: 22 (in progress). Trend: +22% improvement. Blocked: 2 tasks. 1) 'Database migration' — blocked by 'Schema review' (Mike, 2 days). 2) 'Payment integration' — blocked by 'API keys from vendor' (external).
```

## Capabilities

### Inspect project status
You can request detailed metadata for any specific Leiga project.

### Manage task assignments
The agent can create new tasks or retrieve the full details of existing ones, including current assignees and priority levels.

### Review team capacity
Get an overview of assigned work for every team member in a department to check for overload or open slots.

### List active projects
Retrieve a list of all projects configured within your Leiga account.

### Track task lists
Fetch filtered lists of tasks, optionally narrowing the scope by project ID or date range.

## Use Cases

### Checking resource load for the next sprint
A team lead needs to figure out if the design team has bandwidth. They ask their agent to call `list_team_members` and then check current task assignments against capacity, preventing burnout before they even start planning.

### Updating scope after a meeting
A PM just finished a requirements meeting. Instead of opening the system and navigating menus, they prompt their agent to `create_task` for 'Implement new billing logic' and assign it immediately.

### Investigating project delays
The team hits a roadblock. A developer asks the agent to run `get_project_details` and then cross-reference that with all related tasks via `list_tasks` to pinpoint exactly which dependency is causing the holdup.

### Understanding automation gaps
An engineer wants to see what actions are automated. They ask their agent to use `list_workflows` so they can determine if a certain project event already triggers an action, saving them development time.

## Benefits

- You stop losing time manually checking status updates. When you need to know if a task is blocked or who owns it, your agent uses `get_task_details` instantly.
- Team Leads get real-time visibility into resource allocation. By calling `list_team_members`, you can immediately see which team members are at capacity before assigning new work.
- Project Managers no longer need to jump through hoops for status reports. Listing projects with `list_projects` and tracking progress gives you a high-level overview in one chat turn.
- Need to create something? Instead of logging into the UI, just say 'Create task' using `create_task`. The agent handles all the necessary fields right away.
- The MCP allows you to query historical data easily. You can run `list_tasks` filtered by a specific date range to review past sprints without any manual filtering.

## How It Works

The bottom line is, your AI client handles all the API calling; you just talk to it naturally.

1. First, you subscribe to this MCP and enter your unique Leiga API Key.
2. Next, you tell your AI client what data you need—for example, 'Show me all projects and who's blocked on the Mobile App.'
3. The agent calls the relevant tools (like `list_projects` and `get_task_details`), compiles the structured data, and gives it back to you in a clean, conversational format.

## Frequently Asked Questions

**How do I use `list_projects` with Leiga MCP?**
Just ask your agent to list projects; it pulls the names and basic status of every project configured in Leiga. It's a quick way to get an overview before deep diving into any single one.

**Can I create tasks using `create_task`?**
Yes, you can use the agent to write and submit new tasks directly through your chat. You just need to specify what the task is, who it's for, and its priority.

**Does `list_team_members` show active users only?**
It shows all configured team members in your Leiga workspace. It’s useful for verifying roles before you attempt to assign work using the MCP tools.

**What does `get_task_details` provide?**
This tool gives full context on one task, including its current status, who it's assigned to, and a detailed description of what needs doing.

**When I run `get_project_details`, what key metrics about the project are included?**
The tool pulls critical information including current sprint status, total task counts, and assigned team leads. This gives you a comprehensive overview needed to assess overall project health.

**How does `list_workflows` handle filtering by status or criteria?**
It lists all automated workflows configured for your account. You can pass filters, such as a specific project ID or trigger type, to narrow down the results and see only relevant automation rules.

**Can the `list_tasks` tool group tasks by team member or due date?**
Yes, you filter tasks using parameters like assignee name, status labels, or specific project IDs. This allows your agent to quickly review only items assigned to a certain person or overdue.

**If there is an issue with my Leiga credentials, how does the MCP handle errors when using `list_organizational_teams`?**
The MCP returns a specific HTTP error code and detailed message. This immediately tells your agent why access failed (e.g., invalid key), letting you fix authentication without guesswork.

**Can I manage tasks and sprints?**
Yes. Create, update, and assign tasks. Browse sprints with capacity data, velocity metrics, and completion tracking.

**Can I monitor team workload?**
Yes. Track assignments per team member, availability, and workload distribution across projects.

**What API does Leiga use?**
Bearer authentication against `api.leiga.com/v1`.