# Code Climate MCP for AI Agents MCP > Code Climate MCP lets your AI client govern code quality metrics directly from chat. It connects to Code Climate data, giving you immediate visibility into repository grades, test coverage percentages, and technical debt across all your projects. Stop clicking through dashboards; start asking questions about how healthy your codebase is. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** engineering-metrics, code-maintainability, test-coverage, software-intelligence, repository-analytics, dev-productivity ## Description Managing code quality shouldn't require a dozen open tabs or deep dives into complex CI/CD dashboards. This MCP connects Code Climate to any AI agent you use, giving you natural language control over your engineering metrics. You can ask your client things like, 'What is the maintainability grade for our payment service?' and get an instant answer based on historical data. It lets you audit test coverage reports or list all technical debt issues found in a specific commit snapshot without ever logging into the Code Climate dashboard itself. This connection turns complex code analysis into a simple conversation. Whether you're checking compliance grades, reviewing recent snapshots, or monitoring webhook status for DevOps tasks, your AI agent handles the heavy lifting. It’s one of the most useful tools in the Vinkius catalog for any development team that needs real-time visibility into their codebase health. ## Tools ### get_my_codeclimate_profile Retrieves basic information about your own user account profile on Code Climate. ### get_repository_code_quality Fetches detailed code quality metrics, including grades and maintainability scores, for a specific repository. ### get_snapshot_quality_details Provides comprehensive information about a single analysis snapshot from the Code Climate history. ### list_snapshot_code_issues Lists all identified code issues and technical debt findings for a given analysis snapshot. ### list_codeclimate_repositories Retrieves a list of every repository that Code Climate is currently analyzing. ### list_repository_snapshots Gets a chronological list of all available analysis snapshots for a specific project. ### list_repository_test_reports Retrieves and lists the test coverage reports associated with a particular repository. ### list_codeclimate_webhooks Displays all webhooks that are currently configured for real-time analysis notifications on a repository. ## Prompt Examples **Prompt:** ``` What is the current grade for our main API gateway? ``` **Response:** ``` **Code Quality Report: Main API Gateway** * **Overall Grade:** B+ * **Maintainability Score:** 78/100 (Up from 75 last month) * **Critical Issues Found:** 4 (Requires immediate attention) Need a deep dive on those critical issues? Just ask me to list them. ``` **Prompt:** ``` Show me the test coverage for 'user-profile' last week. ``` **Response:** ``` Checking historical reports for user-profile... The most recent report (Snapshot ID: abc1234) shows 91% overall coverage. This is a solid improvement of 3% from the previous month’s analysis. Good work! ``` **Prompt:** ``` List all technical debt issues for the payments module. ``` **Response:** ``` **Technical Debt Report: Payments Module** Found 8 total issues in the last snapshot: * **Critical:** Missing unit tests (2 instances) * **Major:** Outdated dependencies (3 instances) * **Minor:** Code smell detected (3 instances) Focusing on those critical test gaps should be the top priority for this sprint. ``` ## Capabilities ### Check repository grade and overall quality Get a summary of code quality information, including grades and metrics, for an entire project. ### Review specific analysis snapshots Access detailed insights from historical or current Code Climate analyses to track how quality changes over time. ### Audit technical debt issues List all specific code problems and findings identified within a particular snapshot, helping developers prioritize fixes. ### Monitor test coverage reports Retrieve comprehensive lists of test coverage data to ensure your software meets quality standards across the board. ### View and manage webhooks List all configured webhooks for a repository, allowing quick auditing of real-time notification setup. ### Retrieve user account details Fetch metadata about the authenticated user profile and organizational settings within your workspace. ## Use Cases ### Checking if a feature branch is safe to merge A developer asks, 'What's the test coverage on the 'checkout' repository?' Your agent uses `list_repository_test_reports` and reports that it's at 82%, which is above the required minimum of 75%. The merge can proceed. ### Investigating a sudden dip in code quality An Engineering Manager asks, 'Show me all issues found after the last deployment.' Your agent uses `list_snapshot_code_issues` to pull up 15 critical findings from the snapshot taken yesterday. ### Understanding historical maintainability A team lead asks, 'How did Project Alpha's grade change last quarter?' Your agent uses `list_repository_snapshots` to compare the current grade against the one found six months ago. ### Verifying deployment readiness for a microservice A DevOps Engineer asks, 'Are all webhooks set up for Project Beta?' Your agent uses `list_codeclimate_webhooks` and confirms that the webhook is active and pointing to the correct CI/CD endpoint. ## Benefits - Stop opening multiple dashboards. You ask your agent, 'What's the status of Project X?' and get immediate data using `get_repository_code_quality`. - Track how code quality evolves over time by accessing historical analyses through `list_repository_snapshots`, giving you a full audit trail. - Prioritize technical debt instantly. Use `list_snapshot_code_issues` to pull up all identified problems for a specific commit, letting your team focus on the highest-impact fixes. - Verify test safety easily. Run `list_repository_test_reports` to confirm your branch meets minimum coverage requirements before merging. - Audit system connections without logging in. Use `list_codeclimate_webhooks` to confirm that real-time notifications are set up correctly for every project. ## How It Works The bottom line is that you get immediate, conversational access to deep engineering metrics without needing to navigate complex web dashboards. 1. Subscribe to this MCP on Vinkius and provide your Code Climate Personal API Token (found in User Settings). 2. Your AI client connects using the token, granting it direct access to all your monitored repositories' code quality data. 3. You ask a question—like 'What was the test coverage for project X?'—and your agent pulls the specific report details directly into your chat. ## Frequently Asked Questions **How does Code Climate MCP help me check code quality metrics?** This MCP gives you immediate, natural language access to your codebase health. Instead of opening dashboards, you simply ask your agent for the repository grade or maintainability score and get a direct answer. **Can I use Code Climate MCP to track test coverage reports?** Yes. You can retrieve and monitor test coverage data instantly by asking about specific repositories. It shows you percentage increases or drops, which is critical for compliance. **What if I need historical code quality data from Code Climate MCP?** You can access past analyses using the MCP. By referencing snapshot details, your agent pulls up how the grade or issue count looked months ago, making long-term trend analysis simple. **Does Code Climate MCP help me manage technical debt?** Absolutely. The MCP lets you list all identified code issues for any snapshot. This helps teams prioritize which technical debt needs fixing first, turning massive dashboards into actionable lists. **What kind of role is Code Climate MCP best for?** It's perfect for Engineering Managers and DevOps Engineers who need high-level oversight across dozens of projects without spending all day clicking buttons in separate tools.