# Tech Debt Register — MCP tool `findutils:tech_debt_register`

Analyze a technical debt register and return the stakeholder numbers: active vs resolved counts, total hours to fix, weekly "interest" cost in hours, payoff weeks at a given weekly budget, breakeven weeks, counts by category and severity, the top-5 highest-interest items, a severity/effort matrix (quick wins, strategic, low priority, time sink), and an executive-summary paragraph. Each item has a category (code, architecture, testing, documentation, security, performance), a severity 1-5, effort_to_fix in hours, interest_rate in hours lost per week, and a status (active, resolved, wont_fix).

- Category: productivity
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/tech-debt-register/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/tech-debt-register/
- Same tool on the other surface: https://findutils.com/api/tech-debt-register/

## Connect

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "tech_debt_register",
      "arguments": {
        "items": [
          {
            "title": "Flaky login tests",
            "category": "testing",
            "severity": 4,
            "effort_to_fix": 6,
            "interest_rate": 3
          }
        ],
        "weekly_budget": 8
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `items` | array | yes | Debt items: { title, category, severity (1-5), effort_to_fix (hours), interest_rate (hours/week, default 0), status (default "active"), description }. |
| `weekly_budget` | number | no | Hours per week available for paying down debt. Default 8. Default: `8`. |

Example arguments (verified):

```json
{
  "items": [
    {
      "title": "Flaky login tests",
      "category": "testing",
      "severity": 4,
      "effort_to_fix": 6,
      "interest_rate": 3
    }
  ],
  "weekly_budget": 8
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/tech-debt-register/execute \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "title": "Flaky login tests",
        "category": "testing",
        "severity": 4,
        "effort_to_fix": 6,
        "interest_rate": 3
      }
    ],
    "weekly_budget": 8
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/tech-debt-register
```

Full REST reference: https://findutils.com/api/tech-debt-register/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt