MCP Tools

Glaux exposes 2 tools via the Model Context Protocol. Each maps to a specific moment in the agent coding workflow.

All tools require a repo parameter in org/repo format (e.g., tobi/qmd).

glaux_file_intel

When to call: Before editing a file.

Returns pre-edit context for a file: change risk, files to review first, coupling classification (hidden, expected, dormant), volatility, and the primary risk drivers that produced the risk score.

Parameters:

Example response:

{
  "path": "src/server/browserType.ts",
  "churn": {
    "commitCount": 142,
    "recentCommitCount": 12,
    "additionsTotal": 3891,
    "deletionsTotal": 2104
  },
  "coChanges": [
    {
      "path": "src/server/browser.ts",
      "count": 87,
      "confidence": 0.61,
      "trend": "stable"
    }
  ],
  "linkedIssues": [
    {
      "number": 12345,
      "title": "BrowserType.launch hangs on CI",
      "state": "closed",
      "labels": ["bug"],
      "html_url": "https://github.com/tobi/qmd/issues/12345"
    }
  ],
  "centrality": 0.034,
  "community": "cluster-3",
  "pagerank": 0.0087,
  "context": {
    "changeRisk": "high",
    "confidence": 0.8,
    "summaryFlags": ["high-centrality", "hidden-coupling"],
    "primaryDrivers": [
      {
        "type": "hidden_coupling",
        "evidence": { "hiddenCount": 2, "paths": ["src/server/browser.ts"] }
      },
      {
        "type": "high_centrality",
        "evidence": { "centrality": 0.034 }
      }
    ],
    "coupling": {
      "expected": [
        { "path": "src/server/browser.ts", "coChangeCount": 87, "confidence": 0.61 }
      ],
      "hidden": [
        { "path": "src/server/chromium/crBrowser.ts", "coChangeCount": 14, "confidence": 0.22 }
      ],
      "dormant": ["src/server/types.ts"]
    },
    "reviewFirst": ["src/server/browser.ts", "src/server/chromium/crBrowser.ts"],
    "volatility": "active",
    "changePattern": {
      "neverChangedAlone": true,
      "pairedChangeRate": 0.91
    },
    "nextSteps": {
      "readBeforeEdit": ["src/server/browser.ts"],
      "verifyRelatedFiles": ["src/server/chromium/crBrowser.ts"],
      "suggestedCheckTypes": ["integration", "e2e"]
    },
    "hasStaticGraph": true
  }
}

glaux_pr_review

When to call: Before reviewing or merging a pull request.

Returns per-file pre-edit context (same shape as glaux_file_intel) for every file changed in the PR. Surfaces which files carry the highest change risk and which hidden couplings the PR may have missed.

Parameters:

Example response:

{
  "repo": "tobi/qmd",
  "prNumber": 4567,
  "files": [
    {
      "path": "src/server/browserType.ts",
      "churn": {
        "commitCount": 142,
        "recentCommitCount": 12,
        "additionsTotal": 3891,
        "deletionsTotal": 2104
      },
      "coChanges": [
        {
          "path": "src/server/browser.ts",
          "count": 87,
          "confidence": 0.61,
          "trend": "stable"
        }
      ],
      "linkedIssues": [],
      "context": {
        "changeRisk": "high",
        "confidence": 0.8,
        "reviewFirst": ["src/server/browser.ts"],
        "coupling": {
          "expected": [],
          "hidden": [
            { "path": "src/server/browser.ts", "coChangeCount": 87, "confidence": 0.61 }
          ],
          "dormant": []
        },
        "volatility": "active",
        "summaryFlags": ["hidden-coupling"],
        "primaryDrivers": [],
        "changePattern": { "neverChangedAlone": true, "pairedChangeRate": 0.91 },
        "nextSteps": {
          "readBeforeEdit": ["src/server/browser.ts"],
          "verifyRelatedFiles": [],
          "suggestedCheckTypes": ["integration"]
        },
        "hasStaticGraph": false
      }
    }
  ]
}