MCP server

Gluecron ships a Model Context Protocol (MCP) server at POST /mcp. Add it to Claude Code and you can create issues, open PRs, merge pull requests, and more — all from an AI session, with full gate enforcement on every write.

1. Install Claude Code

If you don't have Claude Code yet, install it from claude.ai/code or via npm:

npm install -g @anthropic-ai/claude-code

2. Generate a personal access token

MCP write tools require authentication. Create a token at /settings/tokens — choose the admin scope so merge and close operations are allowed. The token is shown once; copy it immediately. Tokens start with glc_.

3. Add the MCP config

Create an .mcp.json file at the root of your project (this is the file Claude Code actually loads MCP servers from, on both the CLI and web/cloud sessions):

{
  "mcpServers": {
    "gluecron": {
      "type": "http",
      "url": "https://gluecron.com/mcp",
      "headers": {
        "Authorization": "Bearer glc_your_token_here"
      }
    }
  }
}

If you self-host Gluecron, replace gluecron.com with your instance URL.

Alternatively, one-click setup is available at /connect/claude — it generates the JSON snippet with your token pre-filled.

4. Verify the connection

Start Claude Code in your project directory:

claude

# In the session, ask:
# "List open PRs on my-org/my-repo"
# Claude will call gluecron_list_prs and return the results.

Available tools

The MCP server exposes the following tools. Read-only tools work without authentication; write tools require a token with the appropriate scope.

Read-only tools

Tool	Description
`gluecron_repo_search`	Search public repos by keyword. Returns up to 20 results.
`gluecron_repo_read_file`	Read a single file from a public repo at a given ref (branch / tag / commit).
`gluecron_repo_list_issues`	List open issues for a public repo. Returns up to 50 ordered by most-recent.
`gluecron_repo_explain_codebase`	Return the cached AI "explain this codebase" Markdown for a public repo.
`gluecron_repo_health`	Compute the health report for a public repo: overall score (0-100), letter grade, per-category breakdown, and actionable insights.

Write tools (require auth)

Tool	Description
`gluecron_create_issue`	Create a new issue. Returns `{number, url}`.
`gluecron_comment_issue`	Add a comment to an existing issue. Returns `{commentId}`.
`gluecron_close_issue`	Close an open issue (idempotent). Returns `{state}`.
`gluecron_reopen_issue`	Reopen a closed issue (idempotent). Returns `{state}`.
`gluecron_create_pr`	Open a new pull request. Returns `{number, url}`.
`gluecron_get_pr`	Fetch full PR detail (title, body, state, branches, draft, author).
`gluecron_list_prs`	List PRs filtered by state (open\|closed\|merged\|all). Returns up to 50 rows.
`gluecron_comment_pr`	Add a comment to a pull request. Returns `{commentId}`.
`gluecron_merge_pr`	Merge an open PR. Enforces gate checks, branch-protection rules, and the pre-merge risk score. Returns `{merged, sha?, reason?, riskScore?}`.
`gluecron_close_pr`	Close a PR without merging (idempotent). Returns `{state}`.

Example Claude session

# Open an issue
User: "Open an issue on my-org/api titled 'Rate limiter not resetting'"
Claude: [calls gluecron_create_issue]
        Created issue #42: /my-org/api/issues/42

# Create a PR from a feature branch
User: "Open a PR from feat/rate-limit-fix into main"
Claude: [calls gluecron_create_pr with head_branch=feat/rate-limit-fix]
        Opened PR #17: /my-org/api/pulls/17

# Merge after review
User: "Merge PR #17 — I've reviewed it"
Claude: [calls gluecron_merge_pr with number=17]
        Merged PR #17. SHA: a3f9c2d

Gate enforcement on merge

gluecron_merge_pr enforces the same checks as the web UI merge button:

PR must not be a draft.
Head branch ref must resolve.
GateTest hard gates must pass (secrets scan, dependency advisories, policy violations).
Branch-protection rules must be satisfied.
If the pre-merge risk score is critical, the tool returns merged: false with a prompt to re-call with confirm_high_risk: true.

One-click Claude Desktop extension

Download the .dxt extension at /gluecron.dxt. Open it in Claude Desktop — it installs the MCP config automatically. No JSON editing needed.

← PreviousWorkflow YAML Next →API reference

Edit this page