MCP Tools

Glaux exposes 6 tools via the Model Context Protocol. Connect your agent to the Glaux MCP server and these tools become available automatically.

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

glaux_file_intel

Returns full FileIntel for a given file in a repository. Co-change entries include a trend field ("increasing", "decreasing", or "stable") indicating whether the coupling is strengthening, fading, or consistent over time.

Parameters:

Parameter	Type	Required	Default	Description
`repo`	`string`	Yes	-	Repository slug (e.g. `microsoft/playwright`)
`filePath`	`string`	Yes	-	Path to the file within the repo

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"  // "increasing", "decreasing", or "stable"
    }
  ],
  "linkedIssues": [
    {
      "number": 12345,
      "title": "BrowserType.launch hangs on CI",
      "state": "closed",
      "labels": ["bug"],
      "html_url": "https://github.com/microsoft/playwright/issues/12345"
    }
  ],
  "centrality": 0.034,
  "community": "cluster-3",
  "pagerank": 0.0087,
  "riskScore": 0
}

glaux_hot_files

Returns the top files by PageRank score in a repository.

Parameters:

Parameter	Type	Required	Default	Description
`repo`	`string`	Yes	-	Repository slug
`directory`	`string`	No	-	Optional directory prefix filter
`limit`	`number`	No	`10`	Max results

Example response:

[
  {
    "path": "src/server/browserType.ts",
    "pagerank": 0.0087
  },
  {
    "path": "src/server/browser.ts",
    "pagerank": 0.0065
  }
]

glaux_blast_radius

Returns the blast radius (transitively co-changed files) for a given file.

Parameters:

Parameter	Type	Required	Default	Description
`repo`	`string`	Yes	-	Repository slug
`filePath`	`string`	Yes	-	Path to the file
`depth`	`number`	No	`3`	Traversal depth (clamped to 1-5)

Example response:

{
  "depth": 3,
  "affectedFiles": 24,
  "clusters": [
    {
      "name": "cluster-3",
      "files": [
        "src/server/browser.ts",
        "src/server/chromium/crBrowser.ts"
      ]
    },
    {
      "name": "cluster-7",
      "files": [
        "tests/browsertype-launch.spec.ts"
      ]
    }
  ]
}

glaux_communities

Returns detected file clusters (communities) in a repository.

Parameters:

Parameter	Type	Required	Default	Description
`repo`	`string`	Yes	-	Repository slug

Example response:

[
  {
    "name": "cluster-3",
    "files": [
      "src/server/browser.ts",
      "src/server/browserType.ts",
      "src/server/chromium/crBrowser.ts"
    ]
  },
  {
    "name": "cluster-7",
    "files": [
      "tests/browsertype-launch.spec.ts",
      "tests/fixtures.ts"
    ]
  }
]

glaux_pr_context

Returns intel for each file changed in a pull request.

Parameters:

Parameter	Type	Required	Default	Description
`repo`	`string`	Yes	-	Repository slug
`prNumber`	`number`	Yes	-	Pull request number

Example response:

{
  "repo": "microsoft/playwright",
  "prNumber": 4567,
  "files": [
    {
      "path": "src/server/browserType.ts",
      "churn": {
        "commitCount": 142,
        "recentCommitCount": 12,
        "additionsTotal": 3891,
        "deletionsTotal": 2104
      },
      "coChanges": [],
      "linkedIssues": [],
      "riskScore": 0
    }
  ]
}

glaux_status

Returns the sync status for a repository.

Parameters:

Parameter	Type	Required	Default	Description
`repo`	`string`	Yes	-	Repository slug

Example response:

{
  "repo": "microsoft/playwright",
  "synced": true,
  "lastSyncedAt": "2026-02-24T18:30:00.000Z",
  "status": "completed",
  "commitsSynced": 12847,
  "filesDiscovered": 3421
}