> ## Documentation Index
> Fetch the complete documentation index at: https://docs.draftt.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Draftt MCP

The Draftt MCP server connects your LLM or coding agent directly to Draftt's tech debt intelligence. Draftt acts as the intelligence layer: surfacing findings, upgrade plans, ownership, and policy context. The agent acts on that intelligence, opening PRs, creating tickets, updating configurations, or walking an engineer through a remediation step by step.

This is the bridge between Draftt's governance data and the AI tools your engineering teams already use.

## What It Enables

**Remediation, not just reporting.** Instead of surfacing a finding and waiting for a human to act, an LLM agent can read the Draftt upgrade plan for an EOL dependency, understand the required steps, and open a PR, create a ticket, or execute the fix directly, grounded in Draftt's guidance.

**Grounded in your environment.** The agent has access to the actual resource state, ownership, blast radius, and Draftt's recommended remediation path. Every decision is scoped to your specific stack and your specific findings, not a generic playbook.

**Governed by your policies.** The MCP exposes your active governance policies so the agent understands what "good" looks like for your organization and can validate its actions against your standards before applying them.

## Example Interactions

* "Show me all EOL resources owned by the platform team and open PRs for each"
* "What does Draftt recommend for upgrading PostgreSQL 11 in the payments service? Apply it"
* "Find all high-severity findings with no open ticket and create Jira issues for each"
* "Using the draftt MCP get the forecast for Amazon RDS MySQL extended support fees in the following 5 months"
* "What configuration violations exist in production, and what are the fix steps?"
* "Walk me through the upgrade guide for the EKS cluster in the payments account"
* "Using the draftt MCP create a detailed upgrade plan for `<clusterName>` from 1.33 to 1.34. Use the available data to produce cluster-specific commands, not generic options"
* "Using the draftt MCP get compatibility data for the K8s workloads in cluster `<clusterName>` and how to fix incompatible workloads. Provide with commands to run in order to upgrade the relevant Helm chart releases or K8s manifests."
* "Using the draftt MCP get the K8s Nodes status for both clusters `<clusterName>` and `<clusterName>`. Then compare their state - how many issues on each cluster and how each cluster Nodes are managed"

## Connecting the MCP Server

The Draftt MCP server is published as an npm package: [@draftt-io/draftt-mcp](https://www.npmjs.com/package/@draftt-io/draftt-mcp). You will need your Draftt API key, which you can generate in **Settings > User Management > API Keys**.

**Prerequisites**

* Node.js 20.0.0 or later ([download](https://nodejs.org/))

**Quick start with npx:**

```bash theme={null}
npx -y @draftt-io/draftt-mcp --access-key YOUR_ACCESS_KEY
```

**Claude Desktop configuration:**

Add the following to your `claude_desktop_config.json` (on macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):

```json theme={null}
{
  "mcpServers": {
    "draftt": {
      "command": "npx",
      "args": ["-y", "@draftt-io/draftt-mcp", "--access-key", "YOUR_ACCESS_KEY"]
    }
  }
}
```

**Configuration variables:**

| Variable              | Description                                                    |
| --------------------- | -------------------------------------------------------------- |
| `DRAFTT_ACCESS_KEY`   | Required. Your Draftt API key.                                 |
| `DRAFTT_API_BASE_URL` | API endpoint. Defaults to `https://api.draftt.io/v1`.          |
| `MCP_TRANSPORT`       | Transport mode: `stdio` (default) or `sse`.                    |
| `PORT`                | HTTP server port when using SSE transport. Defaults to `3000`. |
| `DEBUG`               | Set to `true` to enable verbose logging.                       |

## Available Tools

| Tool                                | Description                                                                                                                                                                           |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `draftt_component_query`            | Query cloud infrastructure components using DrafttQL with advanced filtering, sorting, and pagination. Start here to discover components when you don't have a specific component ID. |
| `draftt_component_get`              | Retrieve complete details for a specific infrastructure component by its numeric ID                                                                                                   |
| `draftt_policy_query`               | Query compliance policies using DrafttQL with advanced filtering, sorting, and pagination. Use this first to find a policy ID.                                                        |
| `draftt_policy_get`                 | Get full details for a specific policy                                                                                                                                                |
| `draftt_policy_component_get`       | Evaluate a component's compliance against a specific policy                                                                                                                           |
| `draftt_policy_component_query`     | Query multiple compliance evaluations with filtering                                                                                                                                  |
| `draftt_upgrade_guide_get`          | Generate a structured upgrade guide for a Kubernetes cluster                                                                                                                          |
| `draftt_policy_k8s_component_query` | Assess workload compliance within a Kubernetes cluster                                                                                                                                |
| `draftt_k8s_api_query`              | Query Kubernetes API resources (CRDs, native APIs) and their deprecation status for a cluster                                                                                         |
| `draftt_k8s_node_query`             | Query Kubernetes nodes for a cluster with compliance status, versions, management info, and upgrade warnings                                                                          |