MCP Integration
Connect AI assistants like Claude directly to your DevLyTicks data using the Model Context Protocol (MCP). Ask natural language questions about your repositories, contributors, DORA metrics, and more.
The Model Context Protocol (MCP) is an open standard that lets AI assistants securely connect to external data sources and tools. With the DevLyTicks MCP server, you can ask Claude (or any MCP-compatible AI) questions like:
- "Who are our top contributors this month?"
- "What is our deployment frequency for Q4?"
- "Show me any active anomaly alerts"
- "Which repositories need code review attention?"
- "What is our MTTR over the last 30 days?"
API keys authenticate MCP requests to DevLyTicks. Create one from your dashboard:
- Go to Dashboard → Settings → API Keys (or navigate to
/api-keys) - Click Create API Key and give it a name like "Claude MCP"
- Select the permissions you need (at minimum:
analytics:read,repositories:read) - Copy the generated key — it starts with
dtk_and is only shown once
Important: Copy your API key immediately after creation — it cannot be retrieved later.
The DevLyTicks MCP server is a Node.js package. Install it globally:
npm install -g @devlyticks/mcp-server
# Or use npx (no install needed)
npx @devlyticks/mcp-server
Requires Node.js 18+. Check your version with node --version.
The DevLyTicks MCP server works with any MCP-compatible AI assistant. Choose your client below:
Claude Desktop
Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"devlyticks": {
"command": "npx",
"args": ["@devlyticks/mcp-server"],
"env": {
"DEVLYTICKS_API_KEY": "dtk_your_api_key_here",
"DEVLYTICKS_ORG_ID": "your_organization_id",
"DEVLYTICKS_API_URL": "https://api.devlyticks.com"
}
}
}
}Cursor IDE
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"devlyticks": {
"command": "npx",
"args": ["@devlyticks/mcp-server"],
"env": {
"DEVLYTICKS_API_KEY": "dtk_your_api_key_here",
"DEVLYTICKS_ORG_ID": "your_organization_id",
"DEVLYTICKS_API_URL": "https://api.devlyticks.com"
}
}
}
}Windsurf IDE
Config file: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"devlyticks": {
"command": "npx",
"args": ["@devlyticks/mcp-server"],
"env": {
"DEVLYTICKS_API_KEY": "dtk_your_api_key_here",
"DEVLYTICKS_ORG_ID": "your_organization_id",
"DEVLYTICKS_API_URL": "https://api.devlyticks.com"
}
}
}
}Replace dtk_your_api_key_here with your API key and your_organization_id with the ID from your dashboard URL.
After saving, fully restart your AI assistant (quit and reopen). The DevLyTicks tools will appear in the MCP tools list.
The MCP server exposes these tools to your AI assistant:
Analytics
get_analytics_summarySummary stats for a time periodget_analytics_overviewDetailed velocity & quality metricsRepositories
list_repositoriesAll organization repositoriesget_repositoryDetails for a specific repositoryget_repository_commitsRecent commitsget_repository_pull_requestsPull requests with filteringContributors
list_contributorsAll contributors with metricsget_contributorDetailed contributor profileTeams
list_teamsAll teams in the organizationget_team_metricsPerformance metrics for a teamget_team_goalsGoals and progress for a teamEngineering Excellence
get_leaderboardContributor rankingsget_dora_metricsDORA metrics summaryget_alertsActive anomaly alertsReports & Goals
list_report_templatesAvailable report templates by rolelist_generated_reportsPreviously generated reportslist_goal_templatesAvailable goal templatesFor full MCP functionality, create your API key with these permissions:
analytics:readrepositories:readcontributors:readteams:readorganizations:readmetrics:readalerts:readOr select admin for full access.
Server not appearing in Claude
Verify the JSON config syntax is valid and fully quit/reopen Claude Desktop (Cmd+Q on macOS, not just close the window).
Authentication errors
Check that your DEVLYTICKS_API_KEY is correct and not expired. Revoked keys return 401 errors.
Organization ID not found
Your organization ID appears in the dashboard URL: app.devlyticks.com/organizations/YOUR_ORG_ID
Check MCP logs (macOS)