Mergify MCP server for AI agents

Let Claude, ChatGPT or your own agent read Mergify: 2 typed functions through one MCP server. No Mergify API key needed.

Functions
2
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Mergify

An MCP server for Mergify alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/mergify
Every site

One MCP server for Mergify and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 2
  • queueStatusThe live state of a repo's Mergify merge queue.

    Arguments

    NameTypeRequired
    args{ owner: string; repo: string }Yes

    Returns mergifyQueueStatus

    interface mergifyBatch {
      id: string;
      name: string;
      statusCode: string;
      batchFilledSlots: number | null;
      maxBatchSlots: number | null;
      retries: number;
      maxRetries: number;
      startedAt: string | null;
      estimatedMergeAt: string | null;
      estimatedCiFinishAt: string | null;
      ciFinishedAt: string | null;
      queueRuleName: string;
      checksPassed: number;
      checksTotal: number;
      pullRequestNumbers: number[];
    }
    
    interface mergifyQueuedPull {
      number: number;
      title: string;
      url: string;
      author: string | null;
      queuedAt: string;
      priorityRuleName: string | null;
      estimatedMergeAt: string | null;
    }
    
    interface mergifyQueueStatus {
      batches: mergifyBatch[];
      waitingPullRequests: mergifyQueuedPull[];
      paused: boolean;
      pauseReason: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/mergify/queueStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.mergify.queueStatus({ owner: "Mergifyio", repo: "mergify-engine" });
  • validateConfigValidate a Mergify configuration file (.mergify.yml) before pushing it.

    Arguments

    NameTypeRequired
    args{ yaml: string }Yes

    Returns mergifyConfigValidation

    interface mergifyConfigError {
      path: string;
      message: string;
      keyword: string;
    }
    
    type mergifyConfigValidation =
      | { valid: true }
      | { valid: false; errors: mergifyConfigError[] };

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/mergify/validateConfig

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.mergify.validateConfig({ yaml: "queue_rules:\n  - name: default\n" });

Use it from code