swarmia-mcp

A Model Context Protocol (MCP) server that provides access to Swarmia's Export API. This server allows you to fetch various metrics and reports from Swarmia including pull request metrics, DORA metrics, investment balance reports, software capitalization reports, and effort reporting.

This MCP server provides access to the following Swarmia Export API endpoints:

• Pull Request Metrics - Cycle time, review rate, merge time, PRs in progress, etc.
• DORA Metrics - Deployment frequency, change lead time, change failure rate, mean time to recovery
• Investment Balance - Monthly FTE data and investment category breakdowns
• Software Capitalization Report - Employee contributions to capitalizable work
• Software Capitalization Employees - FTE effort breakdown by month for each employee
• Effort Reporting - Authors and their FTE for each issue in a given month

• Python 3.8 or higher
• A Swarmia account with API access
• A Swarmia API token (obtain from Settings/API tokens in your Swarmia dashboard)

To use this MCP server with your favourite MCP client (E.g. Claude, Cursor etc.):

1. Ensure depedancies are installed

make install

1. Add the following to your MCP configuration

   {
     "mcpServers": {
       "swarmia": {
         "command": "/path/to/swarmia-mcp/venv/bin/python3",
         "args": ["/path/to/swarmia-mcp/swarmia_mcp_server.py"],
         "env": {
           "SWARMIA_API_TOKEN": "your_api_token_here"
         }
       }
     }
   }

1. Restart your client application

1. Ask for some metrics

Example queries:

• "Analyze our team's pull request cycle time trends"
• "Get the software capitalization report for Q1 2024"
• "Show me effort reporting for last month"

1. Clone or download this repository
2. Install the required dependencies and setup the project: