# Code Climate MCP for AI Agents AI Agent Connect

> Code Climate MCP. Manage code quality and engineering metrics directly through your AI agent. Track repository grades, audit test coverage, and prioritize technical debt without leaving your chat interface. It gives your agent the eyes it needs to see how your codebase is actually performing, allowing you to make data driven decisions on your technical debt faster. You can monitor maintainability trends across your entire portfolio and get specific details on snapshot issues, making it much easier to manage technical debt across multiple projects simultaneously.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_dEa3ubWm5DI8grNI5Jrd9891vm9odnIoA9LITGNs/ai-agent-connect
- **Tags:** engineering-metrics, code-maintainability, test-coverage, software-intelligence, repository-analytics, dev-productivity

## Description

Stop jumping between tabs just to see if a new pull request tanked your maintainability score. This Connector lets you pull all your Code Climate data into your favorite AI client so you can talk to your codebase metrics like a person. Instead of digging through a dashboard to find out why a project's grade dropped, you can just ask your agent to show you the latest snapshot and highlight the specific issues causing the noise. It's about getting the engineering intelligence you need exactly when you're doing the work. You'll find this is a huge win when using the Vinkius catalog because it puts these deep metrics right where your development happens. You can check coverage reports, audit your webhooks, and keep an eye on the health of every repo in your org without the context switching that usually kills your flow. It turns your AI agent into a high level engineering analyst that can instantly summarize repository health or pull a list of bugs from a specific analysis. You no longer have to remember which projects are lagging or which webhooks are active. You just ask, and the agent handles the data retrieval, giving you a clear picture of your software health in plain English.

## Tools

### get_my_codeclimate_profile
Retrieve your authenticated user profile and organizational metadata. This is useful for confirming your account permissions and organization details.

### get_repository_code_quality
Get a detailed breakdown of the quality metrics for a specific repository. This helps you see the maintainability grade and health status at a glance.

### get_snapshot_quality_details
Get the specific data points for a single analysis snapshot. Use this to see exactly how the code quality changed during a specific point in time.

### list_snapshot_code_issues
List every code issue identified in a particular snapshot. This lets you quickly identify which technical debt items need your attention first.

### list_codeclimate_repositories
List every repository currently being analyzed in your account. This gives you a high-level overview of your entire project portfolio.

### list_repository_snapshots
List all the analysis snapshots for a specific repository. Use this to track how your code quality has evolved over multiple commits.

### list_repository_test_reports
List all the test coverage reports for a specific repository. This makes it easy to monitor how much of your code is actually being tested.

### list_codeclimate_webhooks
List all the webhooks configured for a specific repository. This helps you verify that your automated notifications are set up correctly.

## Prompt Examples

**Prompt:** 
```
What's the current health of my 'auth-service' repo?
```

**Response:** 
```
Checking 'auth-service'... It currently has a Grade: B. The maintainability score is 72/100. I've identified 14 issues in the latest snapshot that you should look at.
```

**Prompt:** 
```
Give me the test coverage for the 'mobile-api'.
```

**Response:** 
```
I've pulled the latest test coverage for 'mobile-api'. It's currently at 88.5%. That's a slight drop from the previous report of 90.2%.
```

**Prompt:** 
```
List all my repositories and their grades.
```

**Response:** 
```
Here are your analyzed projects:

| Repo Name | Grade |
| --- | --- |
| core-api | A |
| web-portal | B |
| data-sync | A |
| legacy-worker | C |
```

## Capabilities

### Get repository quality scores
See the specific maintainability and health stats for any project in your portfolio.

### Pull snapshot details
Look at the data behind a specific code analysis to see exactly what changed.

### List repository issues
Grab a list of all the technical debt items in a snapshot to prioritize your backlog.

### Check test coverage
See how much of your code is actually being tested with real-time reports.

### Audit your webhooks
Manage and monitor the notifications your repositories send out to other services.

### View repository list
See every project currently being tracked in your account in one place.

## Use Cases

### Justifying a technical debt sprint
A manager needs to know why a project grade dropped. They ask the agent to compare the latest two snapshots and list the new issues.

### Verifying test coverage on a hotfix
A developer wants to know if they broke coverage. They ask the agent for the latest test coverage report for the core-api repo.

### Conducting a security audit
A security lead asks the agent to list all repositories and their current health statuses to identify high-risk projects.

### Checking webhook configurations
An engineer asks the agent to list all configured webhooks to verify that the CI/CD pipeline is sending the right alerts.

## Benefits

- Stop the tab switching. You can check repository grades and test coverage without leaving your IDE or chat tool.
- Prioritize technical debt. Use list_snapshot_code_issues to see exactly what needs fixing first based on real data.
- Track quality trends. Use list_repository_snapshots to see how your code health has evolved over multiple commits.
- Audit your webhooks. Check your list_codeclimate_webhooks to make sure your automated alerts are actually firing.
- Get instant context. Use get_repository_code_quality to get a high-level health check on any project in seconds.

## How It Works

The bottom line is you get a direct line to your engineering metrics without leaving your dev environment.

1. Subscribe to the Connector and grab your Personal API Token from your Code Climate settings.
2. Plug that token into your AI client's configuration.
3. Ask your agent to pull repo grades or list issues to start auditing your code quality.

## Frequently Asked Questions

**Can I see my repository grades with Code Climate?**
Yes, you can pull the current health status and maintainability grades for any repository in your account directly through your AI agent.

**How do I check test coverage using Code Climate?**
Your agent can pull the latest test coverage reports for any specific project you have linked to your account.

**Can I see the specific issues in a snapshot?**
Yes, you can ask the agent to list all code issues identified in a specific analysis snapshot to help you prioritize your technical debt.

**Is there a way to check my webhooks?**
You can list all webhooks configured for a repository to ensure your automated notifications are set up correctly.

**Can I see my own profile info?**
This Connector can retrieve your authenticated user profile and organizational metadata directly within your workspace.

**How does this help with technical debt?**
It lets you pull lists of specific issues from snapshots so you can decide what to fix first without having to manually search through a dashboard.

**Can I see the maintainability rating for a specific repository?**
Yes! Use the `get_repository_code_quality` tool with the unique repository ID. The agent will return the current maintainability grade (A-F) and other core health metrics provided by Code Climate.

**How do I check the test coverage percentage for a repository?**
Use the `list_repository_test_reports` tool. Your agent will fetch all test coverage reports associated with the repository, showing the coverage percentage for the most recent runs.

**Where do I find my Code Climate API Token?**
Log in to Code Climate, click on your avatar in the top right, go to **User Settings**, and select **Personal API Tokens**. You can generate and copy your token from that section.