AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Grab an exclusive lease on a PR, issue, branch or file path in a repository you can write, for one of your agent sessions. Pass owner+repo with a bare key (PR/issue number, branch name, path), or target_id '<repository id>:<key>'. Returns lease null when another agent holds an active lease.
PR/issue number, branch name or file path (with owner+repo, or a session scoped to a repo); '<repository id>:<key>'; or a PR/issue id
'issue' | 'pr' | 'branch' | 'file_path'
Repository name (optional, with owner)
Repository owner (optional, with repo)
Lease duration, clamped to 1 second – 1 hour (default 5 minutes)
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Tool list last changed Oct 25, 2026.
Grab an exclusive lease on a PR, issue, branch or file path in a repository you can write, for one of your agent sessions. Pass owner+repo with a bare key (PR/issue number, branch name, path), or target_id '<repository id>:<key>'. Returns lease null when another agent holds an active lease.
| Argument | Type | Description |
|---|---|---|
| repo | string | Repository name (optional, with owner) |
| owner | string | Repository owner (optional, with repo) |
| target_id* | string | PR/issue number, branch name or file path (with owner+repo, or a session scoped to a repo); '<repository id>:<key>'; or a PR/issue id |
| duration_ms | number | Lease duration, clamped to 1 second – 1 hour (default 5 minutes) |
| target_type* | string | 'issue' | 'pr' | 'branch' | 'file_path' |
| agent_session_id* | string |
{
"type": "object",
"required": [
"agent_session_id",
"target_type",
"target_id"
],
"properties": {
"repo": {
"type": "string",
"description": "Repository name (optional, with owner)"
},
"owner": {
"type": "string",
"description": "Repository owner (optional, with repo)"
},
"target_id": {
"type": "string",
"description": "PR/issue number, branch name or file path (with owner+repo, or a session scoped to a repo); '<repository id>:<key>'; or a PR/issue id"
},
"duration_ms": {
"type": "number",
"description": "Lease duration, clamped to 1 second – 1 hour (default 5 minutes)"
},
"target_type": {
"type": "string",
"description": "'issue' | 'pr' | 'branch' | 'file_path'"
},
"agent_session_id": {
"type": "string"
}
}
}Return AI spend rollups. Scope by one of: user_id (self), repo {owner,repo}, or agent_session_id. Defaults to caller's user spend.
| Argument | Type | Description |
|---|---|---|
| repo | string | |
| owner | string | |
| scope | string | 'user' (default) | 'repo' | 'agent' |
| agent_session_id | string |
{
"type": "object",
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"scope": {
"type": "string",
"description": "'user' (default) | 'repo' | 'agent'"
},
"agent_session_id": {
"type": "string"
}
}
}Commit a patch to a branch without sending whole files — the way to change a few lines of a large file. `patch` is a unified diff as `git diff` prints it (one commit, `message` required) OR `git format-patch` mbox output (each patch becomes its own commit with the patch's own message and author, like `git am`; `message` is ignored). Applied server-side with `git apply --cached` against the branch head (created from `base_branch` if missing); blank context lines a transport stripped to empty lines, or trimmed off the end of the patch, are restored first (git still checks them against the file). `expected_head_sha` makes it compare-and-swap (all zeros = branch must not exist yet). Meets the same branch protection, rulesets and secret scan as a git push, and fires CI/webhooks like one. Patch limit 2 MiB. Requires 'repo' scope. Returns {branch, commit_sha, parent_sha, files_changed, files, commits, created} (+ blank_context_lines_restored / trimmed_blank_context_lines_restored when a repair was needed).
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| patch* | string | Unified diff (`git diff`, a/ b/ prefixes) or `git format-patch` mbox text. Max 2 MiB. |
| branch* | string | Target branch (short name). Created if it does not exist. |
| message | string | Commit message. Required for a unified diff; ignored for mbox input (each patch carries its own). |
Approve a pull request: records an 'approved' review by the caller — the same review the web form and POST /api/v2/repos/:owner/:repo/pulls/:number/reviews write, so it counts toward branch protection's required approvals and clears the caller's own earlier request for changes. The PR must be open; its author cannot approve it. Requires write access and 'repo' scope. To request changes use gluecron_request_changes. Returns {reviewId, number, state, url}.
| Argument | Type | Description |
|---|---|---|
| body | string | Optional review comment (Markdown) |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | PR number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"body": {
"type": "string",
"description": "Optional review comment (Markdown)"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "PR number"
}
}
}Assign (or, with remove: true, unassign) users on an issue or pull request. Real assignees since 2026-10-12 — up to 10 per thread, only users who can read the repository; the old `assignee:<username>` labels were migrated. Pass `assignee` (one username) or `assignees` (array). `type` is 'issue' (default) or 'pull_request'. Requires 'repo' scope and write access. Returns {assigned, skipped:[{username, reason}], removed, assignees}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| type | string | issue (default) | pull_request |
| owner* | string | |
| number* | number | |
| remove | boolean | Unassign the given users instead (default false) |
| assignee | string | Username to assign |
| assignees | array | Usernames to assign, strings (alternative to `assignee`) |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string"
},
"type": {
"type": "string",
"description": "issue (default) | pull_request"
},
"owner": {
"type": "string"
},
"number": {
"type": "number"
},
"remove": {
"type": "boolean",
"description": "Unassign the given users instead (default false)"
},
"assignee": {
"type": "string",
"description": "Username to assign"
},
"assignees": {
"type": "array",
"description": "Usernames to assign, strings (alternative to `assignee`)"
}
}
}Apply a set of file writes + deletes as a single atomic commit on a branch (creates the branch if it doesn't exist). The killer agent tool: blob/tree/commit/ref-update sequence. Each change is `{path, content?, content_base64?, deleted?}`. Meets the same branch protection, rulesets and secret scan as a git push, and fires CI/webhooks like one. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| branch* | string | |
| changes* | array | Array of {path, content?|content_base64?, deleted?} entries. |
| message* | string | |
| base_branch | string | Branch to fork from when `branch` doesn't yet exist (default: repo default). |
{
"type": "object",
"required": [
"owner",
"repo",
"branch",
"message",
"changes"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"branch": {
"type": "string"
},
"changes": {
"type": "array",
"description": "Array of {path, content?|content_base64?, deleted?} entries."
},
"message": {
"type": "string"
},
"base_branch": {
"type": "string",
"description": "Branch to fork from when `branch` doesn't yet exist (default: repo default)."
}
}
}Site admins only (needs an 'admin'-scoped token). Backup and restore-drill health: whether the newest backup set is verified on an offsite target and how old it is, whether offsite copies are immutable (Object Lock), when a restore drill last passed, whether the backup worker is running, plus targets (host/bucket, never keys), schedule and recent runs. A stale, failed, local-only or never-drilled backup reads RED. Pass start: 'backup' or 'drill' to queue one for the worker (picked up within 15 minutes; audit-logged). Returns {health, reasons, targets, problems, schedule, runs, started?}.
| Argument | Type | Description |
|---|---|---|
| start | string | Optional: 'backup' or 'drill' — queue one now |
{
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "Optional: 'backup' or 'drill' — queue one now"
}
}
}Cancel a queued/running workflow run. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| run_id* | string | The run's id, or a unique leading part of it (8+ hex characters) |
{
"type": "object",
"required": [
"owner",
"repo",
"run_id"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"run_id": {
"type": "string",
"description": "The run's id, or a unique leading part of it (8+ hex characters)"
}
}
}Send another message to an existing repo chat. Returns the assistant's reply. If the AI service does not answer this fails with a JSON-RPC error carrying {chat_id, ai_error} rather than returning apology copy as a reply.
| Argument | Type | Description |
|---|---|---|
| chat_id* | string | |
| message* | string |
{
"type": "object",
"required": [
"chat_id",
"message"
],
"properties": {
"chat_id": {
"type": "string"
},
"message": {
"type": "string"
}
}
}Start a new chat with a repo: creates a chat row, sends the first user message, streams + persists the assistant reply. Returns {chat_id, reply}. If the AI service does not answer this fails with a JSON-RPC error carrying {chat_id, ai_error} — it never returns apology copy as a reply. Requires authentication.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| title | string | Chat title (optional) |
| message* | string | Initial user message |
{
"type": "object",
"required": [
"owner",
"repo",
"message"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"title": {
"type": "string",
"description": "Chat title (optional)"
},
"message": {
"type": "string",
"description": "Initial user message"
}
}
}Where CI runs and why: mode (external | in-process), declaration (external | in-process | auto) and its source (CI_EXECUTOR on the box, the estate-wide setting, or auto), runners configured / reachable / busy / slots, lastSeenAt, state (ok | degraded | unconfigured | in-process) and holdReason — the sentence every queued run shows when no runner can take it. In-process never runs while external runners are configured. Site admins (admin scope) also get per-runner rows and may pass `declare` (external | in-process | auto) to set the estate-wide setting, audited (the answer then carries `saved`). Same as GET/PUT /api/v2/ci/executor and /admin/runners.
| Argument | Type | Description |
|---|---|---|
| declare | string | Site admins: set the estate-wide declaration to external, in-process or auto. Omit to read only. |
{
"type": "object",
"properties": {
"declare": {
"type": "string",
"description": "Site admins: set the estate-wide declaration to external, in-process or auto. Omit to read only."
}
}
}How full the shared CI queue is, and what to do about it: level (ok / busy / saturated), runs queued and running, runner slots, estimated minutes before a new run starts, and — with owner+repo — that repository's queued/running runs, its share of CI work, the slots it may hold while others wait (per work class, and across classes), a recommendation (e.g. batch changes into fewer pushes), and `explanation`: each work class's queued/running runs (interactive, review, push, schedule) and, for each of the repository's queued runs, its class and why it waits (code + sentence, from the claim plan itself). The same `ciQueue` block the write tools return. Ask before a burst of pushes. Also `executor`: where CI runs (external runners or in-process), runners configured / reachable / busy, and `holdReason` when no runner can take a run. Read-only.
| Argument | Type | Description |
|---|---|---|
| repo | string | Optional, with owner |
| owner | string | Optional, with repo: report this repository's part of the queue |
{
"type": "object",
"properties": {
"repo": {
"type": "string",
"description": "Optional, with owner"
},
"owner": {
"type": "string",
"description": "Optional, with repo: report this repository's part of the queue"
}
}
}Return the authenticated HTTPS clone URL for a repo + a credential-helper hint. Use this instead of embedding tokens in URLs. Returns {url, owner, repo, defaultBranch, hint} using the repo's stored casing.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner username |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner username"
}
}
}Close an open issue. Requires authenticated caller with write access. Idempotent — closing an already-closed issue is a no-op. Returns {state}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | Issue number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "Issue number"
}
}
}Close an open pull request without merging. Requires authenticated caller with write access. Idempotent. Returns {state}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | PR number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "PR number"
}
}
}Add a comment to an existing issue. Requires authenticated caller with write access. Returns {commentId}.
| Argument | Type | Description |
|---|---|---|
| body* | string | Comment body (Markdown) |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | Issue number |
{
"type": "object",
"required": [
"owner",
"repo",
"number",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Comment body (Markdown)"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "Issue number"
}
}
}Add a comment to a pull request. Requires authenticated caller with write access. Returns {commentId}.
| Argument | Type | Description |
|---|---|---|
| body* | string | Comment body (Markdown) |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | PR number |
{
"type": "object",
"required": [
"owner",
"repo",
"number",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Comment body (Markdown)"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "PR number"
}
}
}Mint a new agent-multiplayer session. Returns the plaintext `token` exactly once (store it). Requires 'admin' scope.
| Argument | Type | Description |
|---|---|---|
| name* | string | Human-readable session name (unique per owner) |
| repository_id | string | Optional id of a repository you can write, to scope the session to |
| branch_namespace | string | Optional branch namespace override |
| budget_cents_per_day | number | Daily budget cap in cents (default 500) |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Human-readable session name (unique per owner)"
},
"repository_id": {
"type": "string",
"description": "Optional id of a repository you can write, to scope the session to"
},
"branch_namespace": {
"type": "string",
"description": "Optional branch namespace override"
},
"budget_cents_per_day": {
"type": "number",
"description": "Daily budget cap in cents (default 500)"
}
}
}Create a new branch ref pointing at an existing sha. Mirrors POST /api/v2/repos/.../git/refs. Gated like a push of the new branch (rulesets, secret scan of commits no other ref reaches) and fires CI/webhooks. Requires 'repo' scope. Returns {ref, sha}.
| Argument | Type | Description |
|---|---|---|
| sha* | string | Target commit sha (40-hex) |
| repo* | string | |
| owner* | string | |
| branch* | string | New branch name (short form) |
{
"type": "object",
"required": [
"owner",
"repo",
"branch",
"sha"
],
"properties": {
"sha": {
"type": "string",
"description": "Target commit sha (40-hex)"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"branch": {
"type": "string",
"description": "New branch name (short form)"
}
}
}Mint a short-lived, repository-scoped HTTPS clone credential (a deploy token) and return it once with a ready clone URL — for a sandbox or CI box that has no PAT. Read-only by default; `read_only: false` asks for push access and is granted only if you have write access. Expires in 2 h by default (`expires_in_hours`, max 24). Needs owner / collaborator / team / org access to the repo (public read is not enough) and 'repo' scope. Audit-logged. Returns {id, title, readOnly, expiresAt, token, cloneUrl, url}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| title | string | Where the token will be used (default 'agent clone (MCP)') |
| read_only | boolean | Default true. false = clone AND push (requires write access). |
| expires_in_hours | number | Lifetime in hours (default 2, max 24, min 5 minutes) |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"title": {
"type": "string",
"description": "Where the token will be used (default 'agent clone (MCP)')"
},
"read_only": {
"type": "boolean",
"description": "Default true. false = clone AND push (requires write access)."
},
"expires_in_hours": {
"type": "number",
"description": "Lifetime in hours (default 2, max 24, min 5 minutes)"
}
}
}Create a new issue on a Gluecron repository. Requires authenticated caller with write access on the target repo. Returns {number, url}.
| Argument | Type | Description |
|---|---|---|
| body | string | Issue body (Markdown). Optional. |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| title* | string | Issue title |
{
"type": "object",
"required": [
"owner",
"repo",
"title"
],
"properties": {
"body": {
"type": "string",
"description": "Issue body (Markdown). Optional."
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"title": {
"type": "string",
"description": "Issue title"
}
}
}Open a new pull request. `head_branch` is required; `base_branch` defaults to the repo default branch. Requires authenticated caller with write access. Returns {number, url}.
| Argument | Type | Description |
|---|---|---|
| body | string | PR body (Markdown). Optional. |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| title* | string | PR title |
| base_branch | string | Target branch (default: repo default branch) |
| head_branch* | string | Branch with the changes |
{
"type": "object",
"required": [
"owner",
"repo",
"title",
"head_branch"
],
"properties": {
"body": {
"type": "string",
"description": "PR body (Markdown). Optional."
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"title": {
"type": "string",
"description": "PR title"
},
"base_branch": {
"type": "string",
"description": "Target branch (default: repo default branch)"
},
"head_branch": {
"type": "string",
"description": "Branch with the changes"
}
}
}Mint a fine-grained repository token (`gcft_…`) for ONE repository and return it once. It authenticates the REST API (/api/v2 and the GitHub-compatible /api/v3), git over HTTPS and the container registry (images under owner/repo, by contents) for that repository only. `permissions` sets none/read/write for contents, issues, pull_requests, statuses and actions (admin and settings are never grantable); `expires_in` is optional: omit it (or "never") for no expiration, or give seconds or "30m", "12h", "7d", "1y" (min 5 minutes, max 1 year). Effective access is always held to YOUR current access to the repo, re-checked on every use, and branch protection applies as it does to you. Needs 'repo' scope. Audit-logged. Returns {id, name, repository, permissions, expiresAt, tokenPrefix, token}.
| Argument | Type | Description |
|---|---|---|
| name* | string | Where the token will be used, e.g. 'gatetest deploy box' |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| expires_in | string | Optional lifetime: "30m" / "12h" / "7d" / "1y", or a number of seconds (5 minutes to 1 year). Omit, or "never", for no expiration. |
| permissions* | object | Object of level per permission — keys contents, issues, pull_requests, statuses, actions; values none | read | write; omitted keys are none; at least one must be read or write. Example: {"actions": "read"}. |
Create a one-time CI runner registration token for an owner (your username, an org you own or admin, or 'platform' as a site admin). A runner started with RUNNER_REGISTRATION_TOKEN=<token> registers once and gets its own long-lived credential; that owner's CI then runs on it. Expires in an hour. Returns {owner, token, expiresAt, gluecronUrl}.
| Argument | Type | Description |
|---|---|---|
| owner* | string | Username, org slug, or 'platform' |
| labels | string | Comma-separated labels the runner gets in addition to its own (e.g. gpu,arm64) |
{
"type": "object",
"required": [
"owner"
],
"properties": {
"owner": {
"type": "string",
"description": "Username, org slug, or 'platform'"
},
"labels": {
"type": "string",
"description": "Comma-separated labels the runner gets in addition to its own (e.g. gpu,arm64)"
}
}
}Delete a branch the way `git push --delete` would: write access, then branch protection (allow_deletion), rulesets and the push inspection apply; webhooks and CI fire. The default branch is never deleted. Pass expected_sha to delete only if the branch still points there. A missing branch is a not-found error. Mirrors DELETE /api/v3/repos/:o/:r/git/refs/heads/:branch. Audit-logged. Returns {branch, sha, deleted: true}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| branch* | string | Branch name, without refs/heads/ |
| expected_sha | string | Delete only if the branch still points here (compare-and-swap); otherwise a conflict |
{
"type": "object",
"required": [
"owner",
"repo",
"branch"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"branch": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Branch name, without refs/heads/"
},
"expected_sha": {
"type": "string",
"pattern": "^[0-9a-fA-F]{40}$",
"description": "Delete only if the branch still points here (compare-and-swap); otherwise a conflict"
}
}
}Delete a comment on an issue or pull request (by comment id), with its edit history. Its author or a repository writer only. A missing comment is a not-found error, never reported as deleted. Mirrors DELETE /api/v3/repos/:o/:r/issues/comments/:id. Audit-logged (who wrote it, never what it said). Returns {id, kind, number, deleted: true}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| thread | object | |
| comment_id* | string | The comment's id (as listed by gluecron_list_pr_comments, or the #comment-<id> anchor) |
{
"type": "object",
"required": [
"owner",
"repo",
"comment_id"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"thread": {
"type": "object",
"required": [
"kind",
"number"
],
"properties": {
"kind": {
"enum": [
"issue",
"pr"
],
"type": "string"
},
"number": {
"type": "integer",
"minimum": 1
}
}
},
"comment_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The comment's id (as listed by gluecron_list_pr_comments, or the #comment-<id> anchor)"
}
}
}Delete a file from a branch via git plumbing. Requires the existing blob sha (optimistic concurrency) and 'repo' scope. Meets the same branch protection, rulesets and secret scan as a git push, and fires CI/webhooks like one. Mirrors DELETE /api/v2/contents.
| Argument | Type | Description |
|---|---|---|
| sha* | string | Current blob sha (40-hex) |
| path* | string | |
| repo* | string | |
| owner* | string | |
| branch* | string | |
| message* | string |
{
"type": "object",
"required": [
"owner",
"repo",
"path",
"branch",
"message",
"sha"
],
"properties": {
"sha": {
"type": "string",
"description": "Current blob sha (40-hex)"
},
"path": {
"type": "string"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"branch": {
"type": "string"
},
"message": {
"type": "string"
}
}
}Delete a repository — a SOFT delete (2026-10-19): it disappears at once from git, web, REST, MCP, CI, webhooks, search and pages, its name stays reserved, and it can be restored with gluecron_restore_repo until restorable_until (90 days by default). Queued/running CI is cancelled and pending webhook deliveries are stopped. Only the repository OWNER (the personal owner, or an org owner for an org repository) or a site admin may — admin collaborators and org admins are refused, as in the web UI. Requires 'admin' token scope. Audited as repo.delete; the owner is notified. To remove it for good before then, use gluecron_purge_repo. Returns {deleted: true, soft: true, id, restorable_until}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
}
}
}Delete one workflow secret from a repository by name (cron_secret is read as CRON_SECRET). Idempotent: deleting a secret that is already gone succeeds with deleted:false, already_deleted:true, so a retry is safe. Workflows that reference it stop receiving it. Needs admin access to the repository and 'repo' scope. Audit-logged (name only). Returns {repository, name, deleted, already_deleted, at}.
| Argument | Type | Description |
|---|---|---|
| name* | string | Secret name |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
{
"type": "object",
"required": [
"owner",
"repo",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Secret name"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
}
}
}Delete an Actions variable by name. Pass owner + repo for a repository variable, owner + repo + environment for an environment variable, or org for an organisation variable (organisation variables need an admin-scoped token). A variable that does not exist is a not-found error, never reported as deleted. Audit-logged. Returns {name, deleted: true}.
| Argument | Type | Description |
|---|---|---|
| id | string | Variable id, instead of name |
| org | string | Organisation slug |
| name | string | Variable name: letters, digits and _, not starting with a digit or GITHUB_ (stored upper-case) |
| repo | string | Repo name |
| owner | string | Repo owner — username or organisation slug (omit when passing org) |
| environment | string | Environment name (or id) |
{
"type": "object",
"required": [],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Variable id, instead of name"
},
"org": {
"type": "string",
"description": "Organisation slug"
},
"name": {
"type": "string",
"pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
"maxLength": 100,
"minLength": 1,
"description": "Variable name: letters, digits and _, not starting with a digit or GITHUB_ (stored upper-case)"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug (omit when passing org)"
},
"environment": {
"type": "string",
"description": "Environment name (or id)"
}
}
}Dismiss the standing 'changes requested' reviews on a PR (all of them, or one reviewer's), so they no longer hold the merge. Requires 'repo' scope and write access; the reason is required and audited.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| number* | number | |
| reason* | string | Why the request is dismissed (3-500 characters) |
| reviewer | string | Only this reviewer's request (username). Optional. |
{
"type": "object",
"required": [
"owner",
"repo",
"number",
"reason"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"number": {
"type": "number"
},
"reason": {
"type": "string",
"description": "Why the request is dismissed (3-500 characters)"
},
"reviewer": {
"type": "string",
"description": "Only this reviewer's request (username). Optional."
}
}
}Replace the text of a comment on an issue or pull request (by comment id). Its author or a repository writer only; the previous text is kept in the edit history; the same text again is `unchanged`; a concurrent edit is a conflict, never overwritten. Mentions the edit adds are notified. Mirrors PATCH /api/v3/repos/:o/:r/issues/comments/:id. Returns {id, kind, number, effect}.
| Argument | Type | Description |
|---|---|---|
| body* | string | The new text (Markdown); the previous text is kept in the edit history |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| thread | object | |
| comment_id* | string | The comment's id (as listed by gluecron_list_pr_comments, or the #comment-<id> anchor) |
{
"type": "object",
"required": [
"owner",
"repo",
"comment_id",
"body"
],
"properties": {
"body": {
"type": "string",
"maxLength": 65536,
"minLength": 1,
"description": "The new text (Markdown); the previous text is kept in the edit history"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"thread": {
"type": "object",
"required": [
"kind",
"number"
],
"properties": {
"kind": {
"enum": [
"issue",
"pr"
],
"type": "string"
},
"number": {
"type": "integer",
"minimum": 1
}
}
},
"comment_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The comment's id (as listed by gluecron_list_pr_comments, or the #comment-<id> anchor)"
}
}
}Explain a failed CI run: for each failed step, its class (compile / test / flaky / dependency / env / infra / lint / security / unknown) and the rule that chose it, the normalised error signature, failing tests, the files the commit touched, prior occurrences of the same failure (this repo, your other repos with the same owner or org, and platform-wide counts only) with the fix rate, and a suggested fix — the commit / PR that fixed it last time plus its diff limited to the relevant files, or the class's standard remedy. Infra and flaky failures never suggest a code change. `run_id` is the run's full id; with `owner` + `repo` an 8+ hex prefix also works.
| Argument | Type | Description |
|---|---|---|
| repo | string | Optional: repository name — needed only for a run-id prefix |
| owner | string | Optional: repository owner — needed only for a run-id prefix |
| run_id* | string | The failed run's id (full uuid; an 8+ hex prefix when owner + repo are given) |
| include_diff | boolean | Include the prior fix's diff, limited to the relevant files (default true) |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"repo": {
"type": "string",
"description": "Optional: repository name — needed only for a run-id prefix"
},
"owner": {
"type": "string",
"description": "Optional: repository owner — needed only for a run-id prefix"
},
"run_id": {
"type": "string",
"description": "The failed run's id (full uuid; an 8+ hex prefix when owner + repo are given)"
},
"include_diff": {
"type": "boolean",
"description": "Include the prior fix's diff, limited to the relevant files (default true)"
}
}
}Return the cached AI 'explain this codebase' Markdown for a repo. Pure read — never triggers a new generation (use the web UI for that).
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
}
}
}Find definitions of a symbol by name within a repo. Wraps src/lib/symbols.findDefinitions.
| Argument | Type | Description |
|---|---|---|
| name* | string | Symbol name |
| repo* | string | |
| owner* | string |
{
"type": "object",
"required": [
"owner",
"repo",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Symbol name"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
}
}
}Fork a repository to the authenticated caller's namespace. Mirrors POST /:owner/:repo/fork. Returns {owner, repo, url}. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Source repo name |
| owner* | string | Source repo owner |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Source repo name"
},
"owner": {
"type": "string",
"description": "Source repo owner"
}
}
}Generate a commit message for a diff. Same engine as gluecron_generate_pr_description but explicit for the commit-message use case.
| Argument | Type | Description |
|---|---|---|
| diff* | string | |
| style | string | 'conventional' (default) or 'plain' |
{
"type": "object",
"required": [
"diff"
],
"properties": {
"diff": {
"type": "string"
},
"style": {
"type": "string",
"description": "'conventional' (default) or 'plain'"
}
}
}Generate an AI commit-message-style description for a diff. Uses src/lib/ai-commit-message.ts under the hood; gracefully degrades to a heuristic when ANTHROPIC_API_KEY is missing. Returns {subject, body}.
| Argument | Type | Description |
|---|---|---|
| diff* | string | Unified-diff body |
| style | string | 'conventional' (default) or 'plain' |
{
"type": "object",
"required": [
"diff"
],
"properties": {
"diff": {
"type": "string",
"description": "Unified-diff body"
},
"style": {
"type": "string",
"description": "'conventional' (default) or 'plain'"
}
}
}Generate release notes between two tags. Wraps src/lib/ai-release-notes.generateReleaseNotes. Returns the rendered Markdown + section data.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| to_tag* | string | New tag |
| from_tag | string | Previous tag (optional) |
{
"type": "object",
"required": [
"owner",
"repo",
"to_tag"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"to_tag": {
"type": "string",
"description": "New tag"
},
"from_tag": {
"type": "string",
"description": "Previous tag (optional)"
}
}
}Generate tests for a PR via Claude. Wraps src/lib/ai-test-generator.generateTestsForPr. Mode 'follow-up-pr' opens a new PR; 'append-commit' commits onto the head branch. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| mode | string | 'follow-up-pr' or 'append-commit' |
| repo* | string | |
| owner* | string | |
| number* | number | PR number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"mode": {
"type": "string",
"description": "'follow-up-pr' or 'append-commit'"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"number": {
"type": "number",
"description": "PR number"
}
}
}Return spent / cap / remaining cents for an agent session.
| Argument | Type | Description |
|---|---|---|
| agent_session_id* | string |
{
"type": "object",
"required": [
"agent_session_id"
],
"properties": {
"agent_session_id": {
"type": "string"
}
}
}Read the branch-protection rule that applies to a branch (exact name or the glob that covers it): required checks, require_pr_run, required approvals, AI / human review, green gates, force-push / deletion, auto-merge. Read-only. Returns {protected: false} when no rule applies, else {protected: true, pattern, matched_by, required_checks, …}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| branch | string | Branch name (default: the repo's default branch) |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"branch": {
"type": "string",
"description": "Branch name (default: the repo's default branch)"
}
}
}Fetch a single commit by SHA: metadata plus the list of files it changed (path, status, additions, deletions). Mirrors GET /api/v2/repos/.../commits/:sha. Patch bodies are NOT included — use gluecron_get_diff for those.
| Argument | Type | Description |
|---|---|---|
| sha* | string | Commit SHA |
| repo* | string | |
| owner* | string | |
| include_files | boolean | Include the files-changed summary and stats (default true). Set false to skip the diff read on very large commits. |
{
"type": "object",
"required": [
"owner",
"repo",
"sha"
],
"properties": {
"sha": {
"type": "string",
"description": "Commit SHA"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"include_files": {
"type": "boolean",
"description": "Include the files-changed summary and stats (default true). Set false to skip the diff read on very large commits."
}
}
}Read the actual changes in a commit or a branch range. Pass `sha` for one commit against its first parent, or `base`+`head` for everything head adds since the merge base (what a PR proposes). Returns {files:[{path, oldPath?, status, additions, deletions, binary, patch, patchTruncated}], stats, truncated}. Patch text is byte-capped; set include_patch=false for a files-changed summary only.
| Argument | Type | Description |
|---|---|---|
| sha | string | Commit SHA — diffs it against its first parent |
| base | string | Base ref (with `head`) |
| head | string | Head ref (with `base`) |
| repo* | string | |
| owner* | string | |
| include_patch | boolean | Include patch bodies (default true) |
| max_patch_bytes | number | Total budget for patch text across all files (default 400000, max 2000000) |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"sha": {
"type": "string",
"description": "Commit SHA — diffs it against its first parent"
},
"base": {
"type": "string",
"description": "Base ref (with `head`)"
},
"head": {
"type": "string",
"description": "Head ref (with `base`)"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"include_patch": {
"type": "boolean",
"description": "Include patch bodies (default true)"
},
"max_patch_bytes": {
"type": "number",
"description": "Total budget for patch text across all files (default 400000, max 2000000)"
}
}
}Fetch the full detail record of a pull request (title, body, state, branches, draft, author, timestamps). Authenticated callers only (the read tool surface still works anonymously).
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | PR number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "PR number"
}
}
}List every check at a PR's current head — workflow runs, gates and commit statuses — with status, conclusion, whether branch protection requires it, and the run's log URL; plus each required check's state (passing / pending / failing / missing) and the merge gate's own CI verdict. Read-only. Returns {head_sha, total_count, check_runs, required, ci}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | PR number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "PR number"
}
}
}Return the branch-preview URL + status for a (repo, branch) pair. Wraps branch-previews.getPreviewForBranch. Returns {ok:false, reason:'not enabled on this host'} when the host has no PREVIEW_DOMAIN (no preview would ever resolve).
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| branch* | string |
{
"type": "object",
"required": [
"owner",
"repo",
"branch"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"branch": {
"type": "string"
}
}
}One of your tokens by type and id (from gluecron_list_tokens): everything list shows plus the audit trail (create, edits with a before/after diff, rotations, revocation). Never the secret. `type` is pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_). Same scopes as gluecron_list_tokens.
| Argument | Type | Description |
|---|---|---|
| id* | string | Token id |
| type* | string | Token type: pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_) |
{
"type": "object",
"required": [
"type",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Token id"
},
"type": {
"type": "string",
"description": "Token type: pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_)"
}
}
}Read one Actions variable by name. Pass owner + repo for a repository variable, owner + repo + environment for an environment variable, or org for an organisation variable (organisation variables need an admin-scoped token). Not found is an error. Returns {name, value, createdAt, updatedAt}.
| Argument | Type | Description |
|---|---|---|
| org | string | Organisation slug |
| name* | string | Variable name: letters, digits and _, not starting with a digit or GITHUB_ (stored upper-case) |
| repo | string | Repo name |
| owner | string | Repo owner — username or organisation slug (omit when passing org) |
| environment | string | Environment name (or id) |
{
"type": "object",
"required": [
"name"
],
"properties": {
"org": {
"type": "string",
"description": "Organisation slug"
},
"name": {
"type": "string",
"pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
"maxLength": 100,
"minLength": 1,
"description": "Variable name: letters, digits and _, not starting with a digit or GITHUB_ (stored upper-case)"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug (omit when passing org)"
},
"environment": {
"type": "string",
"description": "Environment name (or id)"
}
}
}Return a workflow run's logs plus a failure summary. Always includes run metadata (number, workflow, event, ref, sha), per-job and per-step status / exit code / duration, `failedSteps` (`job / step`) and `testFailures` (failing test names, read from each step's structured results parsed before its log was cut, or the reason they cannot all be named; null when no job failed). `testFailures.details` marks each failure `flaky` (an active forensic label with a repro, from another run — with its label and flip rate), `known` (also failing on the default branch's latest run), `infra` (timed out under load) or `new`, with its file, message, the targeted retry's verdict and this run's determinism-forensics finding (`forensic`: class, label, variable, repro) when they ran. A step whose log was cut carries `fullLog` (artifact download of the uncut output). `step` (a step name or 1-based position within its job) returns only that step's stdout/stderr; `tail_lines` keeps the last N lines. The full per-job logs are included only when neither is given. JSON-friendly companion to the ZIP-download endpoint.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| step | string | Only this step's logs: its name (exact, else substring, case-insensitive) or its 1-based position within its job |
| owner* | string | |
| run_id* | string | The run's id, or a unique leading part of it (8+ hex characters) |
| tail_lines |
Fetch a workflow run's metadata + status. Mirrors GET /api/v2/repos/.../actions/runs/:id. Also says how it relates to automatic retries: `retryOf` / `retryOfRunNumber` (the run this one retries after a deploy or a lost runner) and `retriedAs` ({id, runNumber} of the run that retried this one, or null). A queued run that no runner can take carries `queueReason` (e.g. "waiting for a runner: 2 configured, 0 reachable, last seen 4m ago"). `workClass` (interactive / review / push / schedule — how the CI claim shares slots); a queued run carries `queue` ({code, text}: its place in the claim order, from the claim plan itself); a schedule run carries `coalescedFires` / `lastCoalescedAt`, and `coalescedNote` when later scheduled fires folded into it while it was queued.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| run_id* | string | The run's id, or a unique leading part of it (8+ hex characters) |
{
"type": "object",
"required": [
"owner",
"repo",
"run_id"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"run_id": {
"type": "string",
"description": "The run's id, or a unique leading part of it (8+ hex characters)"
}
}
}Start here when picking up work: the live state of a repository, read from git and CI rather than from a handoff doc. Returns `summary` (one paragraph), `blockers` (most urgent first), the default branch's CI per workflow (red streak, since when, last green run), the build this Gluecron instance serves and how many commits it is behind (when it is this repository), every open PR grouped green / pending / failing / draft as the merge gate judges it, PRs merged in the last `merged_since_hours` (default 48), and the CI queue. Read-only.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| merged_since_hours | number | Window for recently merged PRs (default 48, max 720) |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"merged_since_hours": {
"type": "number",
"description": "Window for recently merged PRs (default 48, max 720)"
}
}
}Site admins only (needs an 'admin'-scoped token). Import a third-party GitHub Action at ONE tag, branch or full commit SHA into the Gluecron mirror namespace (gluecron-actions/<owner>--<repo>), so workflows that say `uses: owner/repo@ref` can run it. Workflow runs never fetch from github.com; an action that is not imported is skipped. Re-importing the same ref updates it to what upstream has now. Audit-logged. Returns {action, ref, sha, previousSha, mirror, upstreamUrl, hasActionYml}.
| Argument | Type | Description |
|---|---|---|
| ref* | string | Tag, branch or full commit SHA, e.g. v7 |
| action* | string | Upstream action as workflows write it, e.g. actions/github-script |
| upstream_url | string | Optional; default https://github.com/<owner>/<repo>.git |
{
"type": "object",
"required": [
"action",
"ref"
],
"properties": {
"ref": {
"type": "string",
"description": "Tag, branch or full commit SHA, e.g. v7"
},
"action": {
"type": "string",
"description": "Upstream action as workflows write it, e.g. actions/github-script"
},
"upstream_url": {
"type": "string",
"description": "Optional; default https://github.com/<owner>/<repo>.git"
}
}
}Attach one or more labels to an issue. Labels are created if they don't yet exist on the repo. Requires 'repo' scope. Returns {labels}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| labels* | array | Label names (strings) |
| number* | number |
{
"type": "object",
"required": [
"owner",
"repo",
"number",
"labels"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"labels": {
"type": "array",
"description": "Label names (strings)"
},
"number": {
"type": "number"
}
}
}Site admins only (needs an 'admin'-scoped token). Whether CI failures are being turned into lessons: classified failures, lesson.pattern events (matched to a docs/ops/CI_GATE_LESSONS.md row, or candidates), recurring candidates, and failures left without a lesson for over an hour, over 7 days. 'N failures, 0 lessons' reads RED. Also each pattern's count and register row, and the register. Counts only: no log text or repository. Returns {health, patterns, register}.
No arguments.
{
"type": "object",
"properties": {}
}List deleted repositories you can restore or purge: your personal ones and those of organizations you own (a site admin may pass all: true for the whole instance). Each has its id, full_name and restorable_until — after that date it is purged automatically. Read-only. Needs 'repo' scope. Returns {total_count, repositories:[{id, full_name, private, deleted_at, deleted_by, restorable_until}]}.
| Argument | Type | Description |
|---|---|---|
| all | boolean | Site admins only: every deleted repository on the instance |
{
"type": "object",
"properties": {
"all": {
"type": "boolean",
"description": "Site admins only: every deleted repository on the instance"
}
}
}List a repository's flaky tests. A test is flaky only with a forensic repro: when it failed, CI re-ran just that test in the same order, alone, with the clock shifted +137 ms and +1 s, in TZ=Pacific/Chatham and in a fixed random order, and a variable flipped its verdict N times in a row on the same git tree. Each entry has the test, file, state (active / expired / resolved, or unexplained = flipped with no repro, NOT flaky), label (clock-dependent, order-dependent, concurrency-dependent), the variable, the exact repro command, owner, expiry, issue number, flip rate and evidence runs. Information only — flaky tests are never skipped or quarantined; one targeted retry, and the merge gate excuses a failure only when that retry passed in the same run and the label is active.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| limit | number | Max tests (default 25, max 100) |
| owner* | string | |
| window_days | number | Flip evidence from this many days back (default and max 30) |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string"
},
"limit": {
"type": "number",
"description": "Max tests (default 25, max 100)"
},
"owner": {
"type": "string"
},
"window_days": {
"type": "number",
"description": "Flip evidence from this many days back (default and max 30)"
}
}
}List every comment on a pull request in chronological order: general comments (kind `issue_comment`), inline review comments (`review_comment`: path, line, thread {id, inReplyToId, position, replies, resolved, resolvedAt, resolvedBy}) and review summaries (`review`: state approved | changes_requested | commented). Each entry has author {login, type user|bot}, isAi (written by an AI reviewer), body, createdAt, updatedAt. A review thread is the inline comments on one file+line; the earliest is its root and holds the resolved state. Gluecron does not store a review comment's commit or diff side, so `commitId` and `side` are always null. Only approved (moderated) comments; unsubmitted draft reviews are private to their author and not listed. `kind`: all (default) | issue | review (review comments + review summaries). `since`: ISO-8601 — only entries updated at or after it. Paged: `total` is the full filtered count, `nextOffset` pages through it. Works anonymously on public repos; private repos need read access.
| Argument | Type | Description |
|---|---|---|
| kind | string | all (default) | issue (general comments) | review (review comments + review summaries) |
| repo* | string | Repo name |
| limit | number | Max entries (default 50, max 100) |
| owner* | string | Repo owner — username or organisation slug |
| since | string | ISO-8601 timestamp; only entries updated at or after it |
List pull requests on a repo, filtered by state (open|closed|merged|all). Authenticated callers only. Returns up to 50 summary rows.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| limit | number | Max rows per page (default 50, max 100) |
| owner* | string | Repo owner — username or organisation slug |
| state | string | open | closed | merged | all (default: open) |
| offset | number | Rows to skip, for paging. Use `nextOffset` from the previous response. |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"limit": {
"type": "number",
"description": "Max rows per page (default 50, max 100)"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"state": {
"type": "string",
"description": "open | closed | merged | all (default: open)"
},
"offset": {
"type": "number",
"description": "Rows to skip, for paging. Use `nextOffset` from the previous response."
}
}
}List a repository's workflow secrets — NAMES ONLY, with created/updated times; values are never returned. Use it to check that a secret such as CRON_SECRET exists before a workflow needs it. Needs admin access to the repository and 'repo' scope. Returns {repository, total_count, secrets:[{name, created_at, updated_at}]}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
}
}
}List the fine-grained repository tokens you have minted (never the secret): repository, permissions, state (active / expired / revoked), expiry and last use. Needs 'repo' scope.
No arguments.
{
"type": "object",
"properties": {}
}List the CI runners registered to an owner (username, org slug, or 'platform'): id, name, url, labels, slots, online, last seen, revoked; allowSharedOverflow (the setting); and sharedLane, whether the owner's jobs actually run on shared runners: 'used (no own runners)', 'overflow allowed' or 'not used (own runners only)', explained in sharedLaneDetail.
| Argument | Type | Description |
|---|---|---|
| owner* | string | Username, org slug, or 'platform' |
{
"type": "object",
"required": [
"owner"
],
"properties": {
"owner": {
"type": "string",
"description": "Username, org slug, or 'platform'"
}
}
}List your own tokens (never a secret): type, name, status (active / expiring / expired / revoked / never_used / stale), last 4 characters, scopes or permissions, repository, expiry, last use (time, IP, client), use count and rotation state. `type` is pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_), or omit it for all three (types your token's scopes cannot read are listed under `omitted`). PATs need 'user' scope to read; repository and deploy tokens need 'repo'.
| Argument | Type | Description |
|---|---|---|
| type | string | Token type: pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_). Omit for all. |
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Token type: pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_). Omit for all."
}
}
}List directory contents at a ref. `path` scopes the listing to a subtree and is honoured in BOTH modes; `recursive: true` walks the whole subtree instead of one level. Always returns the same shape: {path, ref, recursive, entries, truncated, totalCount}. Recursive entries carry full repo-relative paths; non-recursive entries carry names. A ref that does not exist is an error, never an empty listing.
| Argument | Type | Description |
|---|---|---|
| ref | string | Branch / tag / sha. Omit (or pass HEAD) for the default branch. |
| path | string | Sub-path within the repo |
| repo* | string | |
| owner* | string | |
| recursive | boolean |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"ref": {
"type": "string",
"description": "Branch / tag / sha. Omit (or pass HEAD) for the default branch."
},
"path": {
"type": "string",
"description": "Sub-path within the repo"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"recursive": {
"type": "boolean"
}
}
}List Actions configuration variables (${{ vars.NAME }}) with their values. Pass owner + repo for a repository variable, owner + repo + environment for an environment variable, or org for an organisation variable (organisation variables need an admin-scoped token). Admin of the repository or organisation only. Paged: limit (≤100, default 30) / offset. Mirrors GET …/actions/variables. Returns {scope, total, limit, offset, nextOffset, variables:[{name, value, createdAt, updatedAt}]}.
| Argument | Type | Description |
|---|---|---|
| org | string | Organisation slug |
| repo | string | Repo name |
| limit | integer | Page size, 1–100 (default 30) |
| owner | string | Repo owner — username or organisation slug (omit when passing org) |
| offset | integer | Rows to skip (default 0) |
| environment | string | Environment name (or id) |
{
"type": "object",
"required": [],
"properties": {
"org": {
"type": "string",
"description": "Organisation slug"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, 1–100 (default 30)"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug (omit when passing org)"
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Rows to skip (default 0)"
},
"environment": {
"type": "string",
"description": "Environment name (or id)"
}
}
}List a repository's workflow runs, newest first, with optional branch/status/event filters. Mirrors GET /api/v2/repos/.../actions/runs. The companion to gluecron_get_workflow_run / gluecron_cancel_workflow_run — this is how an agent finds the run ids to inspect or cancel (issue #10493: without it, stale queued runs could not be discovered from the tool surface at all).
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| event | string | push | pull_request | manual | schedule | ... |
| limit | number | Max rows (default 30, max 100) |
| owner* | string | |
| branch | string | Only runs for this branch (short name or refs/heads/...) |
| offset | number | Rows to skip, for paging |
| status | string | queued | running | success | failure | cancelled |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string"
},
"event": {
"type": "string",
"description": "push | pull_request | manual | schedule | ..."
},
"limit": {
"type": "number",
"description": "Max rows (default 30, max 100)"
},
"owner": {
"type": "string"
},
"branch": {
"type": "string",
"description": "Only runs for this branch (short name or refs/heads/...)"
},
"offset": {
"type": "number",
"description": "Rows to skip, for paging"
},
"status": {
"type": "string",
"description": "queued | running | success | failure | cancelled"
}
}
}Merge an open PR. Enforces the same checks as the HTTP merge flow: not a draft, head SHA resolves, GateTest+AI-review hard gates pass, branch-protection rules satisfied. M3: soft-blocks when the pre-merge risk score is `critical` unless `confirm_high_risk: true` is passed. Returns {merged, sha?, reason?, riskScore?}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | PR number |
| confirm_high_risk | boolean | When true, bypass the M3 risk-score soft-block on critical-band PRs. |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "PR number"
},
"confirm_high_risk": {
"type": "boolean",
"description": "When true, bypass the M3 risk-score soft-block on critical-band PRs."
}
}
}Open a draft pull request. Same payload as gluecron_create_pr but forces is_draft=true. Useful for AI-in-progress PRs that shouldn't run mergeability checks yet.
| Argument | Type | Description |
|---|---|---|
| body | string | |
| repo* | string | |
| owner* | string | |
| title* | string | |
| base_branch | string | |
| head_branch* | string |
{
"type": "object",
"required": [
"owner",
"repo",
"title",
"head_branch"
],
"properties": {
"body": {
"type": "string"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"title": {
"type": "string"
},
"base_branch": {
"type": "string"
},
"head_branch": {
"type": "string"
}
}
}Compute a one-shot status summary for a PR: state, risk score (and whether it describes the current head), CI state for the head commit as the merge gate sees it, AI-review verdicts (trio), gate signals. Read-only.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| number* | number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"number": {
"type": "number"
}
}
}Move a QUEUED workflow run into the priority lane: the runner claims it ahead of the class order, highest `level` first (normal < high < critical), then oldest (issue #10898). The lane holds at most a third of the runner slots, so prioritizing many runs cannot starve the rest. Calling again on a prioritized queued run changes its level. Only queued runs; a running or finished run is reported, not changed. Requires 'repo' scope and write access; `high` and `critical` also require a site admin.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| level | string | normal (default) | high | critical — high and critical need a site admin |
| owner* | string | |
| run_id* | string | The run's id, or a unique leading part of it (8+ hex characters) |
{
"type": "object",
"required": [
"owner",
"repo",
"run_id"
],
"properties": {
"repo": {
"type": "string"
},
"level": {
"type": "string",
"description": "normal (default) | high | critical — high and critical need a site admin"
},
"owner": {
"type": "string"
},
"run_id": {
"type": "string",
"description": "The run's id, or a unique leading part of it (8+ hex characters)"
}
}
}Manual trigger for the AI doc-update flow: scans tracked sections on the default branch and opens a PR rewriting stale prose. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
}
}
}Propose a dependency-upgrade PR. Wraps src/lib/migration-assistant.proposeMajorMigration. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| base_sha* | string | Commit sha to fork from |
| changelog | string | Optional changelog text |
| dependency* | string | |
| to_version* | string | |
| from_version* | string |
{
"type": "object",
"required": [
"owner",
"repo",
"dependency",
"from_version",
"to_version",
"base_sha"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"base_sha": {
"type": "string",
"description": "Commit sha to fork from"
},
"changelog": {
"type": "string",
"description": "Optional changelog text"
},
"dependency": {
"type": "string"
},
"to_version": {
"type": "string"
},
"from_version": {
"type": "string"
}
}
}Provision (or re-provision) a sandbox for a PR. Wraps pr-sandbox.provisionSandbox. Requires 'repo' scope. Returns {ok:false, reason:'not enabled on this host'} when no sandbox provisioner runs on the host.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| number* | number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"number": {
"type": "number"
}
}
}PERMANENTLY delete an already-deleted repository now, instead of waiting for its restore window to end. IRREVERSIBLE: the git data, LFS objects, issues, PRs, releases, packages, CI history and settings are removed and cannot be restored (data already in the instance's backups ages out on the backup schedule). Only works on a repository already deleted with gluecron_delete_repo; `confirm` must be its full name (owner/name). Owner (personal owner, or an org owner) or a site admin; needs 'admin' scope. Audited as repo.purge. Returns {purged: true, id, full_name}.
| Argument | Type | Description |
|---|---|---|
| id* | string | The deleted repository's id |
| confirm* | string | The repository's full name, owner/name, to confirm |
{
"type": "object",
"required": [
"id",
"confirm"
],
"properties": {
"id": {
"type": "string",
"description": "The deleted repository's id"
},
"confirm": {
"type": "string",
"description": "The repository's full name, owner/name, to confirm"
}
}
}Read a file from a repo at a given ref. Mirrors GET /api/v2/repos/:owner/:repo/contents/:path. Returns {path, size, content, encoding, totalLines}. Pass `start_line` / `end_line` (1-based, inclusive) to read only part of a text file. A text file over ~60 KB read with no range returns its first ~60 KB of whole lines with `truncated: true`, `startLine`/`endLine` and a hint — ask for the next range to read on.
| Argument | Type | Description |
|---|---|---|
| ref | string | Branch / tag / sha (default HEAD) |
| path* | string | |
| repo* | string | |
| owner* | string | |
| encoding | string | 'utf8' (default) or 'base64' |
| end_line | number | Last line to return (1-based, inclusive; clamped to the file's length). Text files only. |
| start_line | number | First line to return (1-based, inclusive). Text files only. |
{
"type": "object",
"required": [
"owner",
"repo",
"path"
],
"properties": {
"ref": {
"type": "string",
"description": "Branch / tag / sha (default HEAD)"
},
"path": {
"type": "string"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"encoding": {
"type": "string",
"description": "'utf8' (default) or 'base64'"
},
"end_line": {
"type": "number",
"description": "Last line to return (1-based, inclusive; clamped to the file's length). Text files only."
},
"start_line": {
"type": "number",
"description": "First line to return (1-based, inclusive). Text files only."
}
}
}Plan + execute a refactor that spans multiple repos owned by the caller. Wraps src/lib/multi-repo-refactor.ts. `dry_run: true` returns the plan only. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | When true, returns the plan and does NOT execute. |
| description* | string | Natural-language description |
| repository_ids | array | Optional explicit repo IDs to scope the refactor to. |
{
"type": "object",
"required": [
"description"
],
"properties": {
"dry_run": {
"type": "boolean",
"description": "When true, returns the plan and does NOT execute."
},
"description": {
"type": "string",
"description": "Natural-language description"
},
"repository_ids": {
"type": "array",
"description": "Optional explicit repo IDs to scope the refactor to."
}
}
}Release a lease by id. Idempotent. Returns {released}.
| Argument | Type | Description |
|---|---|---|
| lease_id* | string |
{
"type": "object",
"required": [
"lease_id"
],
"properties": {
"lease_id": {
"type": "string"
}
}
}Reopen a previously closed issue. Requires authenticated caller with write access. Idempotent. Returns {state}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | Issue number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "Issue number"
}
}
}Return the cached AI 'explain this codebase' Markdown for a public repo (most recent commit). Returns null when no cached explanation exists yet.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
}
}
}Compute the current health report for a public repo: overall score (0-100), letter grade, per-category breakdown (security/testing/complexity/dependencies/documentation/activity), and a list of insights to fix next. Backed by computeHealthScore in src/lib/intelligence.ts.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
}
}
}List open issues for a public repository. Returns up to 50 ordered by most-recent.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| limit | number | Max rows per page (default 25, max 50) |
| owner* | string | Repo owner — username or organisation slug |
| offset | number | Rows to skip, for paging. Use `nextOffset` from the previous response. |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"limit": {
"type": "number",
"description": "Max rows per page (default 25, max 50)"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"offset": {
"type": "number",
"description": "Rows to skip, for paging. Use `nextOffset` from the previous response."
}
}
}Read a single file from a repository at a given ref (branch / tag / commit). Private repos are readable when the authenticated caller has access. Returns the text content (binary files rejected).
| Argument | Type | Description |
|---|---|---|
| ref | string | Branch / tag / commit. Defaults to the repository's actual default branch (which may not be 'main' — e.g. 'Main'). |
| path* | string | File path within the repo |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
{
"type": "object",
"required": [
"owner",
"repo",
"path"
],
"properties": {
"ref": {
"type": "string",
"description": "Branch / tag / commit. Defaults to the repository's actual default branch (which may not be 'main' — e.g. 'Main')."
},
"path": {
"type": "string",
"description": "File path within the repo"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
}
}
}Search Gluecron repositories by keyword (name + description), case-insensitively. Returns public repos plus any private repos owned by the authenticated caller. Default 20 per page, max 50; `total` is the full match count and `nextOffset` pages through it.
| Argument | Type | Description |
|---|---|---|
| limit | number | Max rows per page (default 20, max 50) |
| query* | string | Search keyword (1-100 chars) |
| offset | number | Rows to skip. Use `nextOffset` from the previous response. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "number",
"description": "Max rows per page (default 20, max 50)"
},
"query": {
"type": "string",
"description": "Search keyword (1-100 chars)"
},
"offset": {
"type": "number",
"description": "Rows to skip. Use `nextOffset` from the previous response."
}
}
}Request changes on a PR. Records a 'changes requested' review by the caller, which holds the PR on every merge path (web button, API, MCP merge, merge queue, merge train, autopilot) until the caller approves or someone with write access dismisses it (gluecron_dismiss_review), and posts the body as a comment. Requires 'repo' scope and write access.
| Argument | Type | Description |
|---|---|---|
| body* | string | Review body (Markdown) |
| repo* | string | |
| owner* | string | |
| number* | number |
{
"type": "object",
"required": [
"owner",
"repo",
"number",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Review body (Markdown)"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"number": {
"type": "number"
}
}
}Re-run a failed or cancelled workflow run at the SAME commit (same inputs, same PR merge preview) — the run page's Re-run. Gluecron re-runs every job of the run (per-job re-run does not exist yet); a successful or still-running run is refused. Joins an identical queued run instead of stacking another. Requires write access and 'repo' scope. Returns {runId, previousRunId, joinedExistingRun, url}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| run_id* | string | The run's id (uuid) |
{
"type": "object",
"required": [
"owner",
"repo",
"run_id"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"run_id": {
"type": "string",
"description": "The run's id (uuid)"
}
}
}Restore a deleted repository by id (from gluecron_list_deleted_repos) before its restorable_until date: git data, LFS objects, issues, PRs, collaborators and webhooks come back exactly as they were. Cancelled CI runs stay cancelled and stopped webhook deliveries are not re-sent. Refused when another repository now has the same name in that namespace. Owner (personal owner, or an org owner) or a site admin; needs 'admin' scope. Audited as repo.restore. Returns {restored: true, id, full_name}.
| Argument | Type | Description |
|---|---|---|
| id* | string | The deleted repository's id |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The deleted repository's id"
}
}
}Approve or reject a workflow run's jobs waiting on a protected environment (`environment:` with required reviewers). The caller must be a reviewer of every environment selected (the environment's reviewers, or the repository owner when none are listed). An approval runs the job (after the environment's wait timer, if any); a rejection fails it. Mirrors POST /api/v2/repos/.../actions/runs/:id/pending_deployments. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| owner* | string | |
| state* | string | "approved" or "rejected" |
| run_id* | string | The run's id, or a unique leading part of it (8+ hex characters) |
| comment | string | |
| environments | array | Environment names (or ids), as strings, to decide; omitted = every waiting one |
{
"type": "object",
"required": [
"owner",
"repo",
"run_id",
"state"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"state": {
"type": "string",
"description": "\"approved\" or \"rejected\""
},
"run_id": {
"type": "string",
"description": "The run's id, or a unique leading part of it (8+ hex characters)"
},
"comment": {
"type": "string"
},
"environments": {
"type": "array",
"description": "Environment names (or ids), as strings, to decide; omitted = every waiting one"
}
}
}Revoke one of your fine-grained repository tokens by id (from gluecron_list_repo_tokens). It stops working on its next use. Needs 'repo' scope. Audit-logged.
| Argument | Type | Description |
|---|---|---|
| id* | string | Token id |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Token id"
}
}
}Revoke a CI runner by id: nothing is dispatched to it from now on, its next heartbeat is refused and it stops accepting jobs. Cannot be undone — register a new runner instead. Returns {id, revoked}.
| Argument | Type | Description |
|---|---|---|
| id* | string | Runner id (from gluecron_list_runners) |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Runner id (from gluecron_list_runners)"
}
}
}Revoke one of your tokens by type and id. It stops working on its next use; this cannot be undone. `type` is pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_). PATs need 'admin' scope; repository and deploy tokens need 'repo'. Audit-logged.
| Argument | Type | Description |
|---|---|---|
| id* | string | Token id |
| type* | string | Token type: pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_) |
{
"type": "object",
"required": [
"type",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Token id"
},
"type": {
"type": "string",
"description": "Token type: pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_)"
}
}
}Rotate one of your tokens: mint a new secret with the same name, scopes / permissions, repository and expiry, returned ONCE as `token`. `grace_seconds` (default 0, max 604800 = 7 days) keeps the old secret working that long; 0 kills it now. Rotating again ends an earlier grace period. `expected_rotation_count` (from gluecron_get_token's rotationCount) makes it compare-and-swap; two concurrent rotations never both win. `type` is pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_). PATs need 'admin' scope; repository and deploy tokens need 'repo'. Audit-logged.
| Argument | Type | Description |
|---|---|---|
| id* | string | Token id |
| type* | string | Token type: pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_) |
| grace_seconds | number | Seconds the old secret keeps working (0 to 604800). Default 0. |
| expected_rotation_count | number | Optional compare-and-swap guard: the rotationCount you last saw. |
{
"type": "object",
"required": [
"type",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Token id"
},
"type": {
"type": "string",
"description": "Token type: pat (personal access token, glc_), repo (repository token, gcft_) or deploy (deploy token, gcdt_)"
},
"grace_seconds": {
"type": "number",
"description": "Seconds the old secret keeps working (0 to 604800). Default 0."
},
"expected_rotation_count": {
"type": "number",
"description": "Optional compare-and-swap guard: the rotationCount you last saw."
}
}
}Literal / regex code search (git grep, basic regex) across a repo at a ref. The dependable way to find code on this host — works on every repo, indexed or not. Optional scoping: `path` (a directory or file prefix, literal), `glob` (git pathspec glob such as `src/**/*.ts`, relative to `path` when both are given), `ignore_case`, and `files_only` (unique files with match counts instead of lines). Returns {owner, repo, ref, total, truncated, matches: [{file, line, text}]}, or with files_only {owner, repo, ref, total, totalMatches, truncated, files: [{file, count}]}. Omit `ref` for the default branch.
| Argument | Type | Description |
|---|---|---|
| ref | string | Branch / tag / sha (default: the repo's default branch) |
| glob | string | Only search files matching this git pathspec glob (e.g. **/*.test.ts); relative to `path` when both are given |
| path | string | Only search under this repo-relative directory or file (literal prefix, e.g. src/lib) |
| repo* | string | |
| limit | number | Max matches, or max files with files_only (default 50, max 200) |
| owner* | string | |
| query* |
Search issues by title/body keyword on a single repo, filtered by state. Returns ranked rows.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| limit | number | |
| owner* | string | |
| query* | string | Search keyword |
| state | string | open | closed | all (default open) |
{
"type": "object",
"required": [
"owner",
"repo",
"query"
],
"properties": {
"repo": {
"type": "string"
},
"limit": {
"type": "number"
},
"owner": {
"type": "string"
},
"query": {
"type": "string",
"description": "Search keyword"
},
"state": {
"type": "string",
"description": "open | closed | all (default open)"
}
}
}Search pull requests by title/body keyword on a repo.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| limit | number | |
| owner* | string | |
| query* | string | |
| state | string | open|closed|merged|all (default open) |
{
"type": "object",
"required": [
"owner",
"repo",
"query"
],
"properties": {
"repo": {
"type": "string"
},
"limit": {
"type": "number"
},
"owner": {
"type": "string"
},
"query": {
"type": "string"
},
"state": {
"type": "string",
"description": "open|closed|merged|all (default open)"
}
}
}Search repositories by owner, name, owner/name or description, case-insensitively: every public repo, plus the private ones you own or collaborate on when authenticated. Omit `query` (authenticated) to list YOUR repositories — the ones you own or were invited to — instead of searching. Mirrors GET /api/v2/search/repos. `total` is the full match count (not the page size) and `nextOffset` pages through it.
| Argument | Type | Description |
|---|---|---|
| sort | string | stars | updated | name (default: stars) |
| limit | number | Max rows per page (default 30, max 100) |
| query | string | Search keyword — matches owner login, repo name, owner/name and description. Omit to list your own repositories. |
| offset | number | Rows to skip. Use `nextOffset` from the previous response. |
{
"type": "object",
"properties": {
"sort": {
"type": "string",
"description": "stars | updated | name (default: stars)"
},
"limit": {
"type": "number",
"description": "Max rows per page (default 30, max 100)"
},
"query": {
"type": "string",
"description": "Search keyword — matches owner login, repo name, owner/name and description. Omit to list your own repositories."
},
"offset": {
"type": "number",
"description": "Rows to skip. Use `nextOffset` from the previous response."
}
}
}Everything Gluecron actually knows about a repository's security, in one honest call: OSV.dev CVE/GHSA advisories against the indexed dependency graph (with FIXED VERSIONS), Gluecron's supplemental advisory list, a full-tree committed-secret scan, and optionally a Claude semantic code review. Unlike gluecron_repo_health, an empty result is NEVER reported as a pass: every category returns status 'assessed' | 'partial' | 'not_assessed' | 'error' with a machine-readable reason code, so you can tell 'we checked and it is clean' from 'we never looked'. In particular, a repo whose dependency graph was never indexed returns dependency_advisories.status='not_assessed' (reason 'dependency_graph_not_indexed'), not an empty advisory list. Read-only.
| Argument | Type | Description |
|---|---|---|
| ref | string | Branch, tag or commit SHA to scan the tree of. Default: the repo's default branch. Note advisories describe the INDEXED dependency graph, whose commit is reported separately — if it differs from this ref the advisory answer is downgraded to 'partial'. |
| repo* | string | Repo name |
| owner* | string | Repo owner username |
| include_ai_review | boolean | Opt in to the Claude Sonnet semantic review (SQLi/XSS/SSRF/authz/crypto). Costs an Anthropic call and adds seconds. Default false. When it cannot run — no key, provider error, unparseable output — the category reports 'not_assessed', never a pass. |
| max_candidate_lines |
Query the per-repo vector index (Voyage embeddings when configured, hash fallback otherwise). Reads the live per-push index (code_embeddings) first, falling back to the manually-reindexed chunk index (code_chunks). Returns {hits, source, indexed, indexedFiles} — `indexed: false` means the repo has never been indexed (empty hits are NOT 'no match'); `indexedFiles` is the live-index row count.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| limit | number | |
| owner* | string | |
| query* | string |
{
"type": "object",
"required": [
"owner",
"repo",
"query"
],
"properties": {
"repo": {
"type": "string"
},
"limit": {
"type": "number"
},
"owner": {
"type": "string"
},
"query": {
"type": "string"
}
}
}Arm (enabled: true) or disarm (enabled: false) auto-merge on one PR: it merges by itself through the full gated merge chain (CI, required checks, branch protection, CODEOWNERS, risk) once CI and every required check are green and no reviewer with write access has changes requested. Stays armed while anything is pending; `last_attempt.reason` says what it waits for. Arming is also the merge train's consent: on a repository with the train on, the train merges only armed PRs, so disarming holds the PR from it (an explicit gluecron_merge_pr still merges). Requires write access and 'repo' scope. merge_method: 'merge' only. Returns {number, auto_merge}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | PR number |
| enabled* | boolean | true = arm, false = disarm |
| merge_method | string | 'merge' (default; the only method the gated chain has) |
{
"type": "object",
"required": [
"owner",
"repo",
"number",
"enabled"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "PR number"
},
"enabled": {
"type": "boolean",
"description": "true = arm, false = disarm"
},
"merge_method": {
"type": "string",
"description": "'merge' (default; the only method the gated chain has)"
}
}
}Set branch protection for one branch (partial update: fields you omit keep their value). Edits the rule named exactly after the branch; when only a glob rule covers it, a new exact rule is created seeded from the glob's settings and checks. required_checks replaces the required-check list ([] clears it). require_pr_run: a required check that names a workflow is met only by that workflow's pull_request run. Requires ADMIN access to the repo and 'repo' scope. Audit-logged. Returns the resulting rule plus {created, warnings}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| branch* | string | Branch name (not a pattern) |
| allow_deletion | boolean | |
| require_pr_run | boolean | Workflow checks count only from the PR's pull_request run |
| required_checks | array | Array of check names that must pass (workflow names, gate names or commit-status contexts); [] clears the list |
| allow_force_push | boolean | |
| enable_auto_merge |
Mark a pull request ready for review (draft=false) or convert it back to a draft (draft=true). Same rule as the web 'Ready for review' button: the caller needs write access and must be the PR author or the repository owner; only an open PR changes; marking ready starts the AI review. Idempotent. Requires 'repo' scope. Returns {number, isDraft, changed}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| draft* | boolean | true = convert to draft, false = mark ready for review |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | PR number |
{
"type": "object",
"required": [
"owner",
"repo",
"number",
"draft"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"draft": {
"type": "boolean",
"description": "true = convert to draft, false = mark ready for review"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "PR number"
}
}
}Create or replace one workflow secret on a repository, used in workflows as ${{ secrets.NAME }}. The name is saved upper-cased (cron_secret → CRON_SECRET); trailing spaces/newlines are removed from the value. The value is WRITE-ONLY: it is encrypted at rest and never returned, logged or audited — the result names the secret only. Pass expected_updated_at (the updated_at you last read) to update only if nobody changed it since: a newer value is never overwritten (error 'conflict'), a deleted secret is not re-created (error 'missing'). Setting the value it already has writes nothing (result 'unchanged'), so a retry is safe. Needs admin access to the repository and 'repo' scope. Audit-logged (name only). Returns {repository, name, created, result: 'created'|'updated'|'unchanged', updated_at}.
| Argument | Type | Description |
|---|---|---|
| name* | string | Secret name: letters, digits, underscores; not starting with a digit |
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| value* | string | The secret value (never echoed back) |
| expected_updated_at | string | Optional ISO time: only update if the secret's updated_at is still this (from gluecron_list_repo_secrets) |
{
"type": "object",
"required": [
"owner",
"repo",
"name",
"value"
],
"properties": {
"name": {
"type": "string",
"description": "Secret name: letters, digits, underscores; not starting with a digit"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"value": {
"type": "string",
"description": "The secret value (never echoed back)"
},
"expected_updated_at": {
"type": "string",
"description": "Optional ISO time: only update if the secret's updated_at is still this (from gluecron_list_repo_secrets)"
}
}
}Create or replace an Actions variable (plain text, not for secrets — use gluecron_set_repo_secret). Pass owner + repo for a repository variable, owner + repo + environment for an environment variable, or org for an organisation variable (organisation variables need an admin-scoped token). Safe to retry: the same value again changes nothing. Audit-logged. Returns {name, effect: created|updated|unchanged, updatedAt}.
| Argument | Type | Description |
|---|---|---|
| org | string | Organisation slug |
| name* | string | Variable name: letters, digits and _, not starting with a digit or GITHUB_ (stored upper-case) |
| repo | string | Repo name |
| owner | string | Repo owner — username or organisation slug (omit when passing org) |
| value* | string | Plain-text value (not a secret: shown on the settings page and in logs), at most 48 KB |
| environment | string | Environment name (or id) |
{
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"org": {
"type": "string",
"description": "Organisation slug"
},
"name": {
"type": "string",
"pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
"maxLength": 100,
"minLength": 1,
"description": "Variable name: letters, digits and _, not starting with a digit or GITHUB_ (stored upper-case)"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug (omit when passing org)"
},
"value": {
"type": "string",
"maxLength": 49152,
"description": "Plain-text value (not a secret: shown on the settings page and in logs), at most 48 KB"
},
"environment": {
"type": "string",
"description": "Environment name (or id)"
}
}
}Drop a spec file in .gluecron/specs/ with status: ready so the autopilot picks it up. Wraps voice-to-pr.shipAsSpec — handle both voice + manual specs. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| body* | string | Spec body (Markdown) |
| repo* | string | |
| owner* | string | |
| title* | string |
{
"type": "object",
"required": [
"owner",
"repo",
"title",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Spec body (Markdown)"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"title": {
"type": "string"
}
}
}Dispatch a workflow_dispatch run. Mirrors POST /api/v2/repos/.../actions/workflows/:filename/dispatches. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| ref | string | Branch / tag / sha (default: repo default branch) |
| repo* | string | |
| owner* | string | |
| inputs | object | Workflow inputs (object) |
| filename* | string | Workflow filename (e.g. ci.yml) |
{
"type": "object",
"required": [
"owner",
"repo",
"filename"
],
"properties": {
"ref": {
"type": "string",
"description": "Branch / tag / sha (default: repo default branch)"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"inputs": {
"type": "object",
"description": "Workflow inputs (object)"
},
"filename": {
"type": "string",
"description": "Workflow filename (e.g. ci.yml)"
}
}
}Detach a label from an issue. Idempotent. Requires 'repo' scope. Returns {removed: boolean}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | |
| label* | string | |
| owner* | string | |
| number* | number |
{
"type": "object",
"required": [
"owner",
"repo",
"number",
"label"
],
"properties": {
"repo": {
"type": "string"
},
"label": {
"type": "string"
},
"owner": {
"type": "string"
},
"number": {
"type": "number"
}
}
}Edit a pull request's title, body, base branch and/or draft state. Title / body / base: the PR's author or anyone with write access; draft: the same rule as gluecron_set_pr_draft (write access and the PR author or repo owner; marking ready starts the AI review). Needs 'repo' scope. Changing the base (open PRs only) re-runs the PR's pull_request CI against the new base and disarms auto-merge. Returns {number, title, body, baseBranch, headBranch, isDraft, changed, autoMergeDisarmed, url}.
| Argument | Type | Description |
|---|---|---|
| base | string | New base branch |
| body | string | New body (Markdown); an empty string clears it |
| repo* | string | Repo name |
| draft | boolean | true = back to draft, false = ready for review (gluecron_set_pr_draft's rule: write access and the PR author or repo owner) |
| owner* | string | Repo owner — username or organisation slug |
| title | string | New title |
| number* | number | PR number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"base": {
"type": "string",
"description": "New base branch"
},
"body": {
"type": "string",
"description": "New body (Markdown); an empty string clears it"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"draft": {
"type": "boolean",
"description": "true = back to draft, false = ready for review (gluecron_set_pr_draft's rule: write access and the PR author or repo owner)"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"title": {
"type": "string",
"description": "New title"
},
"number": {
"type": "number",
"description": "PR number"
}
}
}Bring a PR branch up to date with its base: merge the base into the head server-side (the PR page's 'Update branch'). Never a force-push — the new head is a merge commit moved through the push gates, so it gets CI. On conflict nothing changes and `conflictFiles` lists the paths. Requires write access and 'repo' scope. Returns {ok, status: 'updated'|'up-to-date', headSha, previousHeadSha, baseSha, url} or {ok: false, reason, message, conflictFiles}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner — username or organisation slug |
| number* | number | PR number |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"number": {
"type": "number",
"description": "PR number"
}
}
}Update repository description / visibility / default_branch. Requires 'admin' access on the repo (owner, org owners/admins, admin collaborators) and 'repo' scope. Returns {ok: true}.
| Argument | Type | Description |
|---|---|---|
| repo* | string | Repo name |
| owner* | string | Repo owner username |
| automation | object | Per-repo automation dials, same keys as Settings → Automation: ai_review_mode, pr_triage_mode, issue_triage_mode, auto_merge_mode, ci_autofix_mode, auto_repair_mode, auto_issues_mode, doc_drift_mode, merge_train_mode. Values: off | suggest | auto (merge_train_mode runs only on auto). Only the keys given change. |
| is_private | boolean | Set visibility (optional) |
| description | string | New description (optional) |
| default_branch | string | Set default branch (optional) |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner username"
},
"automation": {
"type": "object",
"description": "Per-repo automation dials, same keys as Settings → Automation: ai_review_mode, pr_triage_mode, issue_triage_mode, auto_merge_mode, ci_autofix_mode, auto_repair_mode, auto_issues_mode, doc_drift_mode, merge_train_mode. Values: off | suggest | auto (merge_train_mode runs only on auto). Only the keys given change."
},
"is_private": {
"type": "boolean",
"description": "Set visibility (optional)"
},
"description": {
"type": "string",
"description": "New description (optional)"
},
"default_branch": {
"type": "string",
"description": "Set default branch (optional)"
}
}
}Interpret a free-form voice transcript and either ship it as a spec or create an issue (caller picks via `as`). Wraps src/lib/voice-to-pr.ts. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| as | string | 'spec' or 'issue' (default: auto via interpretVoiceTranscript) |
| repo* | string | |
| owner* | string | |
| transcript* | string |
{
"type": "object",
"required": [
"owner",
"repo",
"transcript"
],
"properties": {
"as": {
"type": "string",
"description": "'spec' or 'issue' (default: auto via interpretVoiceTranscript)"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"transcript": {
"type": "string"
}
}
}Who this connector is on this Gluecron instance: the signed-in username and email, whether that account is a site admin, the token's scopes, and how many repositories it owns or collaborates on. Call it first when a repository seems missing — the answer is usually which account authorized the connector. Anonymous callers get authenticated:false and a hint.
No arguments.
{
"type": "object",
"properties": {}
}Create or update a file on a branch via git plumbing. Wraps `createOrUpdateFileOnBranch`. Pass `content` as a UTF-8 string OR `content_base64` for binary. Meets the same branch protection, rulesets and secret scan as a git push, and fires CI/webhooks like one. Requires 'repo' scope.
| Argument | Type | Description |
|---|---|---|
| path* | string | |
| repo* | string | |
| owner* | string | |
| branch* | string | |
| content | string | UTF-8 file body (optional) |
| message* | string | Commit message |
| content_base64 | string | Base64 file body (optional) |
| expect_blob_sha | string | Optimistic-concurrency check: existing blob sha must match. |
{
"type": "object",
"required": [
"owner",
"repo",
"path",
"branch",
"message"
],
"properties": {
"path": {
"type": "string"
},
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"branch": {
"type": "string"
},
"content": {
"type": "string",
"description": "UTF-8 file body (optional)"
},
"message": {
"type": "string",
"description": "Commit message"
},
"content_base64": {
"type": "string",
"description": "Base64 file body (optional)"
},
"expect_blob_sha": {
"type": "string",
"description": "Optimistic-concurrency check: existing blob sha must match."
}
}
}| base_branch |
| string |
| Branch to fork from when `branch` does not exist yet (default: the repo's default branch). |
| expected_head_sha | string | Optional compare-and-swap: the 40-hex sha you expect `branch` to point at. Refused if it moved. All zeros = the branch must not exist. |
{
"type": "object",
"required": [
"owner",
"repo",
"branch",
"patch"
],
"properties": {
"repo": {
"type": "string"
},
"owner": {
"type": "string"
},
"patch": {
"type": "string",
"description": "Unified diff (`git diff`, a/ b/ prefixes) or `git format-patch` mbox text. Max 2 MiB."
},
"branch": {
"type": "string",
"description": "Target branch (short name). Created if it does not exist."
},
"message": {
"type": "string",
"description": "Commit message. Required for a unified diff; ignored for mbox input (each patch carries its own)."
},
"base_branch": {
"type": "string",
"description": "Branch to fork from when `branch` does not exist yet (default: the repo's default branch)."
},
"expected_head_sha": {
"type": "string",
"description": "Optional compare-and-swap: the 40-hex sha you expect `branch` to point at. Refused if it moved. All zeros = the branch must not exist."
}
}
}{
"type": "object",
"required": [
"owner",
"repo",
"name",
"permissions"
],
"properties": {
"name": {
"type": "string",
"description": "Where the token will be used, e.g. 'gatetest deploy box'"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"expires_in": {
"type": "string",
"description": "Optional lifetime: \"30m\" / \"12h\" / \"7d\" / \"1y\", or a number of seconds (5 minutes to 1 year). Omit, or \"never\", for no expiration."
},
"permissions": {
"type": "object",
"description": "Object of level per permission — keys contents, issues, pull_requests, statuses, actions; values none | read | write; omitted keys are none; at least one must be read or write. Example: {\"actions\": \"read\"}."
}
}
}| number |
| Keep only the last N lines of each returned log (max 5000) |
{
"type": "object",
"required": [
"owner",
"repo",
"run_id"
],
"properties": {
"repo": {
"type": "string"
},
"step": {
"type": "string",
"description": "Only this step's logs: its name (exact, else substring, case-insensitive) or its 1-based position within its job"
},
"owner": {
"type": "string"
},
"run_id": {
"type": "string",
"description": "The run's id, or a unique leading part of it (8+ hex characters)"
},
"tail_lines": {
"type": "number",
"description": "Keep only the last N lines of each returned log (max 5000)"
}
}
}| number* | number | PR number |
| offset | number | Entries to skip. Use `nextOffset` from the previous response. |
{
"type": "object",
"required": [
"owner",
"repo",
"number"
],
"properties": {
"kind": {
"type": "string",
"description": "all (default) | issue (general comments) | review (review comments + review summaries)"
},
"repo": {
"type": "string",
"description": "Repo name"
},
"limit": {
"type": "number",
"description": "Max entries (default 50, max 100)"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"since": {
"type": "string",
"description": "ISO-8601 timestamp; only entries updated at or after it"
},
"number": {
"type": "number",
"description": "PR number"
},
"offset": {
"type": "number",
"description": "Entries to skip. Use `nextOffset` from the previous response."
}
}
}| string |
| Pattern (git grep basic regex) |
| files_only | boolean | Return unique files with match counts instead of matching lines |
| ignore_case | boolean | Case-insensitive match (default false) |
{
"type": "object",
"required": [
"owner",
"repo",
"query"
],
"properties": {
"ref": {
"type": "string",
"description": "Branch / tag / sha (default: the repo's default branch)"
},
"glob": {
"type": "string",
"description": "Only search files matching this git pathspec glob (e.g. **/*.test.ts); relative to `path` when both are given"
},
"path": {
"type": "string",
"description": "Only search under this repo-relative directory or file (literal prefix, e.g. src/lib)"
},
"repo": {
"type": "string"
},
"limit": {
"type": "number",
"description": "Max matches, or max files with files_only (default 50, max 200)"
},
"owner": {
"type": "string"
},
"query": {
"type": "string",
"description": "Pattern (git grep basic regex)"
},
"files_only": {
"type": "boolean",
"description": "Return unique files with match counts instead of matching lines"
},
"ignore_case": {
"type": "boolean",
"description": "Case-insensitive match (default false)"
}
}
}| number |
| Cap on lines the secret detector inspects (1-200000, default 20000). The whole tree is always prefiltered; only lines that already matched a secret marker are inspected, so this rarely binds. When it does, committed_secrets reports 'partial' with the exact fraction. |
{
"type": "object",
"required": [
"owner",
"repo"
],
"properties": {
"ref": {
"type": "string",
"description": "Branch, tag or commit SHA to scan the tree of. Default: the repo's default branch. Note advisories describe the INDEXED dependency graph, whose commit is reported separately — if it differs from this ref the advisory answer is downgraded to 'partial'."
},
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner username"
},
"include_ai_review": {
"type": "boolean",
"description": "Opt in to the Claude Sonnet semantic review (SQLi/XSS/SSRF/authz/crypto). Costs an Anthropic call and adds seconds. Default false. When it cannot run — no key, provider error, unparseable output — the category reports 'not_assessed', never a pass."
},
"max_candidate_lines": {
"type": "number",
"description": "Cap on lines the secret detector inspects (1-200000, default 20000). The whole tree is always prefiltered; only lines that already matched a secret marker are inspected, so this rarely binds. When it does, committed_secrets reports 'partial' with the exact fraction."
}
}
}| boolean |
| Branch-wide autopilot auto-merge (K2) |
| required_approvals | number | Human approvals required (0-10) |
| require_ai_approval | boolean |
| require_green_gates | boolean |
| require_human_review | boolean |
| require_pull_request | boolean |
| dismiss_stale_reviews | boolean |
{
"type": "object",
"required": [
"owner",
"repo",
"branch"
],
"properties": {
"repo": {
"type": "string",
"description": "Repo name"
},
"owner": {
"type": "string",
"description": "Repo owner — username or organisation slug"
},
"branch": {
"type": "string",
"description": "Branch name (not a pattern)"
},
"allow_deletion": {
"type": "boolean"
},
"require_pr_run": {
"type": "boolean",
"description": "Workflow checks count only from the PR's pull_request run"
},
"required_checks": {
"type": "array",
"description": "Array of check names that must pass (workflow names, gate names or commit-status contexts); [] clears the list"
},
"allow_force_push": {
"type": "boolean"
},
"enable_auto_merge": {
"type": "boolean",
"description": "Branch-wide autopilot auto-merge (K2)"
},
"required_approvals": {
"type": "number",
"description": "Human approvals required (0-10)"
},
"require_ai_approval": {
"type": "boolean"
},
"require_green_gates": {
"type": "boolean"
},
"require_human_review": {
"type": "boolean"
},
"require_pull_request": {
"type": "boolean"
},
"dismiss_stale_reviews": {
"type": "boolean"
}
}
}