gitcafe

endpoint

https://git.cafe/mcp

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is gitcafe live?

Yes — it answered the hub's last check (checked 2h ago). It answered 100% of checks over the last 30 days.

Is gitcafe free to use?

Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.

What tools does gitcafe have?

21 tools: ci_read, get_me, list_tree, update_comment, list_repositories, update_pull_request, get_repository, list_refs, ….

Is gitcafe safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• get_me auth-required 2h ago

  Read who this connection is signed in as and what it may reach: your actor identity and, for an OAuth connection, the repositories and permissions the user approved and when it expires. Returns null when the credential names no user. Call it first to learn which repositories the other tools can reach; a repository connected later needs a new connection.

  mcp-tool

  123456

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [],
    "properties": {}
  }

  arguments 6 lines copy
• list_tree auth-required never probed

  List the entries of one directory of a repository, not recursively, at a branch, tag or commit, one page at a time; later pages stay on the same commit. Each entry says whether it is a file, directory, submodule or symbolic link. Omit path for the root; pass a tree's path back to descend and a blob's path to read_file.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo"
    ],
    "properties": {
      "oid": {
        "type": "string",
        "pattern": "^[0-9a-f]{40}$",
        "description": "The exact commit to read, as a 40-character hexadecimal OID; takes precedence over ref. Use it to keep several reads on one commit."
      },
      "ref": {
        "type": "string",
        "default": "HEAD",
        "maxLength": 255,
        "minLength": 1,
        "description": "The revision to read: a branch or tag name from list_refs, a full ref such as refs/heads/main or refs/tags/v1, HEAD (the default branch), or a commit OID. Use the full ref when a branch and a tag share a name. Ignored when oid is set."
      },
      "path": {
        "type": "string",
        "maxLength": 4096,
        "minLength": 1,
        "description": "The directory to list, by its path from the repository root, e.g. src/mcp; omit for the root."
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "after": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]+$",
        "maxLength": 8192,
        "minLength": 1,
        "description": "The next cursor from the previous page, to continue the listing on the same commit; omit for the first page."
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 200,
        "minimum": 1,
        "description": "How many entries to return in this page; omit for the default page size."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      }
    },
    "additionalProperties": false
  }

  arguments 53 lines copy
• update_comment auth-required never probed

  Change one comment, one action per call: edit the body of an issue or pull request comment, or resolve or unresolve a pull request thread. Returns the version the next write takes. Take the comment ID and current version from issue_read or pull_request_read facet comments or the last receipt; the write fails if the comment changed since. To resolve or unresolve, pass the thread's root comment (its threadId) and that root's version. An edit overwrites the old text, which is not kept; resolution stays in GitCafe and is not written to GitHub. Comments cannot be hidden or deleted with these tools.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "target",
      "comment",
      "action",
      "input"
    ],
    "properties": {
      "pull": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The pull request's number within the repository (the 42 of #42), from list_pull_requests or a create_pull_request receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "input": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "body",
              "expectedVersion"
            ],
            "properties": {
              "body": {
                "type": "string",
                "maxLength": 65536,
                "minLength": 1,
                "description": "The new body, in Markdown; it replaces the old text, which is not kept."
              },
              "expectedVersion": {
                "type": "integer",
                "maximum": 2147483646,
                "minimum": 0,
                "description": "The comment's current version, from the comments facet or the last receipt; the write fails if the comment changed since, so read it again and retry."
              }
            },
            "description": "For action edit.",
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "expectedVersion"
            ],
            "properties": {
              "expectedVersion": {
                "type": "integer",
                "maximum": 2147483646,
                "minimum": 0,
                "description": "The thread root comment's current version. The write fails if it changed since."
              }
            },
            "description": "For actions resolve and unresolve.",
            "additionalProperties": false
          }
        ],
        "description": "Shape depends on target and action; each option says when it applies."
      },
      "issue": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The issue's number within the repository (the 42 of #42), from list_issues or a create_issue receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "action": {
        "enum": [
          "edit",
          "resolve",
          "unresolve"
        ],
        "type": "string",
        "description": "edit: replace the comment's body. resolve or unresolve: mark the thread resolved, or open it again."
      },
      "target": {
        "enum": [
          "issue",
          "pull"
        ],
        "type": "string",
        "description": "issue: a comment on the issue numbered issue. pull: a comment on the pull request numbered pull."
      },
      "comment": {
        "type": "string",
        "description": "ID of the comment to change, from issue_read facet comments (target issue), pull_request_read facet comments (target pull) or an add_comment receipt. To resolve or unresolve a thread, pass the thread's root comment, whose id equals its threadId."
      }
    },
    "additionalProperties": false
  }

  arguments 102 lines copy
• list_repositories auth-required 2h ago

  List the repositories this connection can read, oldest first, one page at a time, narrowed by owner, topic or name prefix (filters combine). Signed in, it lists the approved repositories; without sign-in it lists public repositories only, needs owner or topic, and q is not available. Pass an item's owner and name to the other tools.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [],
    "properties": {
      "q": {
        "type": "string",
        "maxLength": 100,
        "minLength": 2,
        "description": "Only repositories whose name starts with this text, ignoring case. Needs sign-in; combines with owner and topic."
      },
      "after": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]+$",
        "maxLength": 8192,
        "minLength": 1,
        "description": "The next cursor from the previous page, to continue the list; omit for the first page."
      },
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 50,
        "minimum": 1,
        "description": "How many repositories to return in this page; omit for the default page size."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "Only repositories owned by this user or organization, by handle (acme for acme/website). Combines with topic and q: a repository must match every filter given."
      },
      "topic": {
        "type": "string",
        "pattern": "^[a-z0-9][a-z0-9-]{0,49}$",
        "description": "Only repositories tagged with this topic, e.g. rust. Combines with owner and q."
      }
    }
  }

  arguments 37 lines copy
• update_pull_request auth-required never probed

  Change one pull request, one action per call: edit its title, description or target branch; close it without merging (which also clears draft); reopen it; mark it as a draft; or mark it ready for review. Returns the version the next write takes. Take the number and current version from pull_request_read, list_pull_requests or the last receipt; the write fails if the pull request changed since. An edit overwrites the previous values, which are not kept; title, description and state changes also reach a linked GitHub pull request. Merging is merge_pull_request; reviewers, labels and assignees cannot be changed with these tools.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "pull",
      "action",
      "input"
    ],
    "properties": {
      "pull": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The pull request's number within the repository (the 42 of #42), from list_pull_requests or a create_pull_request receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "input": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "expectedVersion"
            ],
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1,
                "description": "The new heading; omit to keep the current one."
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 65536
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The new body, in Markdown; null clears it, omit keeps it."
              },
              "targetBranch": {
                "type": "string",
                "maxLength": 255,
                "description": "The new target branch of an open pull request, by the short name of an existing branch, e.g. main; omit to keep the current one."
              },
              "expectedVersion": {
                "type": "integer",
                "maximum": 2147483646,
                "minimum": 0,
                "description": "The pull request's current version, from pull_request_read, list_pull_requests or the last receipt; the write fails if the pull request changed since, so read it again and retry."
              }
            },
            "description": "For action edit: expectedVersion and at least one field to change.",
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "expectedVersion"
            ],
            "properties": {
              "expectedVersion": {
                "type": "integer",
                "maximum": 2147483646,
                "minimum": 0,
                "description": "The pull request's current version, from pull_request_read, list_pull_requests or the last receipt; the write fails if the pull request changed since, so read it again and retry."
              }
            },
            "description": "For actions close, reopen, draft and ready.",
            "additionalProperties": false
          }
        ],
        "description": "Shape depends on action; each option says when it applies."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "action": {
        "enum": [
          "edit",
          "close",
          "reopen",
          "draft",
          "ready"
        ],
        "type": "string",
        "description": "edit: change the fields in input. close: close without merging; this also clears draft. reopen: reopen a closed pull request that was not merged. draft: mark an open pull request as a draft. ready: mark a draft as ready for review."
      }
    },
    "additionalProperties": false
  }

  arguments 101 lines copy
• get_repository auth-required never probed

  Read one repository: its identity, description, topics, visibility, default branch, fork parent, version and timestamps. Use it to find the default branch before list_refs, list_tree or read_file, and the id before create_pull_request.

  mcp-tool

  123456789101112131415161718192021

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo"
    ],
    "properties": {
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      }
    },
    "additionalProperties": false
  }

  arguments 21 lines copy
• list_refs auth-required never probed

  List a repository's branches or its tags, sorted by name, one page at a time, optionally narrowed by a name substring. Each ref carries the commit it points to and, for an annotated tag, its signature check. Pass a ref's name as ref to list_tree, read_file or search_code, or its target commit's oid as oid to pin later reads to one commit.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo"
    ],
    "properties": {
      "kind": {
        "enum": [
          "branches",
          "tags"
        ],
        "type": "string",
        "default": "branches",
        "description": "branches: list branches (the default). tags: list tags."
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "after": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]+$",
        "maxLength": 8192,
        "minLength": 1,
        "description": "The next cursor from the previous page, to continue the list; omit for the first page."
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 200,
        "minimum": 1,
        "description": "How many refs to return in this page; omit for the default page size."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "search": {
        "type": "string",
        "maxLength": 200,
        "description": "Only refs whose name contains this text, ignoring case; omit for every ref."
      }
    },
    "additionalProperties": false
  }

  arguments 49 lines copy
• read_file auth-required never probed

  Read one file of a repository at a branch, tag or commit, a window of lines at a time. A text file comes with its line window and nextLine to continue; a binary file comes with null content. A window holds at most maxLines lines and 64 KiB; a file over 1 MiB cannot be read. Take path from list_tree or search_code.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "path"
    ],
    "properties": {
      "oid": {
        "type": "string",
        "pattern": "^[0-9a-f]{40}$",
        "description": "The exact commit to read, as a 40-character hexadecimal OID; takes precedence over ref. Use it to keep several reads on one commit."
      },
      "ref": {
        "type": "string",
        "default": "HEAD",
        "maxLength": 255,
        "minLength": 1,
        "description": "The revision to read: a branch or tag name from list_refs, a full ref such as refs/heads/main or refs/tags/v1, HEAD (the default branch), or a commit OID. Use the full ref when a branch and a tag share a name. Ignored when oid is set."
      },
      "path": {
        "type": "string",
        "maxLength": 4096,
        "minLength": 1,
        "description": "The file to read, by its path from the repository root, e.g. src/index.ts, as list_tree and search_code report it."
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "maxLines": {
        "type": "integer",
        "default": 200,
        "maximum": 500,
        "minimum": 1,
        "description": "How many lines to return at most in this window; omit for the default. Fewer come back when the window reaches 64 KiB or the end of the file."
      },
      "startLine": {
        "type": "integer",
        "default": 1,
        "maximum": 9007199254740991,
        "description": "The first line to return, counting from 1; pass the previous result's nextLine to continue. Omit to start at the top.",
        "exclusiveMinimum": 0
      }
    },
    "additionalProperties": false
  }

  arguments 54 lines copy
• search_code auth-required never probed

  Search the text files of a repository at a branch, tag or commit for a literal string, optionally within one file or directory. Matches come one per matching line, in file and line order, with context lines; truncated says when maxMatches or a size limit cut them short, so narrow by path or raise maxMatches. Pass a match's path and lineNumber to read_file.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "pattern"
    ],
    "properties": {
      "oid": {
        "type": "string",
        "pattern": "^[0-9a-f]{40}$",
        "description": "The exact commit to read, as a 40-character hexadecimal OID; takes precedence over ref. Use it to keep several reads on one commit."
      },
      "ref": {
        "type": "string",
        "default": "HEAD",
        "maxLength": 255,
        "minLength": 1,
        "description": "The revision to read: a branch or tag name from list_refs, a full ref such as refs/heads/main or refs/tags/v1, HEAD (the default branch), or a commit OID. Use the full ref when a branch and a tag share a name. Ignored when oid is set."
      },
      "path": {
        "type": "string",
        "maxLength": 4096,
        "minLength": 1,
        "description": "Only search this file or directory, by its path from the repository root, e.g. src; omit to search the whole repository."
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "pattern": {
        "type": "string",
        "maxLength": 500,
        "minLength": 1,
        "description": "The text to look for, matched literally: regular-expression characters have no special meaning."
      },
      "ignoreCase": {
        "type": "boolean",
        "default": false,
        "description": "true to match regardless of letter case; omit or false to match the exact case."
      },
      "maxMatches": {
        "type": "integer",
        "default": 100,
        "maximum": 1000,
        "minimum": 1,
        "description": "How many matching lines to return at most; omit for the default. Further matches set truncated."
      },
      "contextLines": {
        "type": "integer",
        "default": 3,
        "maximum": 10,
        "minimum": 0,
        "description": "How many lines to include before and after each match; omit for the default."
      }
    },
    "additionalProperties": false
  }

  arguments 65 lines copy
• list_issues auth-required never probed

  List a repository's issues, newest first, one page at a time, optionally narrowed by workflow state or by words in the title or description; total counts every match. Pass an issue's number as issue to issue_read, update_issue and add_comment, and reuse the label, assignee and milestone IDs it shows when creating issues.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo"
    ],
    "properties": {
      "q": {
        "type": "string",
        "maxLength": 200,
        "description": "Only issues whose title or description contains every one of these words, ignoring case; omit for every issue."
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "after": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]+$",
        "maxLength": 8192,
        "minLength": 1,
        "description": "The next cursor from the previous page, to continue the list; omit for the first page."
      },
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 50,
        "minimum": 1,
        "description": "How many issues to return in this page; omit for the default page size."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "state": {
        "enum": [
          "triage",
          "backlog",
          "unstarted",
          "started",
          "completed",
          "canceled"
        ],
        "type": "string",
        "description": "Only issues in this workflow state. triage: awaiting review. backlog: accepted, not planned. unstarted: planned. started: in progress. completed: done. canceled: closed without doing it. Omit for every state."
      }
    },
    "additionalProperties": false
  }

  arguments 52 lines copy
• issue_read auth-required never probed

  Read one issue, one facet per call. detail (the default): the issue, with its version and what you may do to it. comments: one page of its comments, oldest first, with the IDs and versions update_comment takes. Take the issue number from list_issues or a create_issue receipt.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "issue"
    ],
    "properties": {
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "after": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]+$",
        "maxLength": 8192,
        "minLength": 1,
        "description": "For comments: the next cursor from the previous page, to continue the comments; omit for the first page."
      },
      "facet": {
        "enum": [
          "detail",
          "comments"
        ],
        "type": "string",
        "default": "detail",
        "description": "detail: the issue itself, with its version and capabilities (the default). comments: one page of its comments, oldest first."
      },
      "issue": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The issue's number within the repository (the 42 of #42), from list_issues or a create_issue receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 50,
        "minimum": 1,
        "description": "For comments: how many comments to return in this page; omit for the default page size."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      }
    },
    "additionalProperties": false
  }

  arguments 51 lines copy
• list_pull_requests auth-required never probed

  List a repository's pull requests, oldest first, one page at a time, optionally narrowed by lifecycle state or by text in the title. Each item carries the number, head commit and version the other pull request tools take. For a pull request's description, merge readiness, reviews, commits, files or comments call pull_request_read.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo"
    ],
    "properties": {
      "q": {
        "type": "string",
        "maxLength": 200,
        "description": "Only pull requests whose title contains this text, ignoring case; omit for every pull request."
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "after": {
        "type": "string",
        "description": "The next value from the previous page (a pull request ID, pr_...), to continue the list; omit for the first page."
      },
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 50,
        "minimum": 1,
        "description": "How many pull requests to return in this page; omit for the default page size."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "state": {
        "enum": [
          "open",
          "closed",
          "merged"
        ],
        "type": "string",
        "description": "Only pull requests in this lifecycle state. open: can still be changed and merged. closed: closed without merging. merged: merged into the target branch. Omit for every state."
      }
    },
    "additionalProperties": false
  }

  arguments 46 lines copy
• pull_request_read auth-required never probed

  Read one pull request, one facet per call. detail: the pull request, with its version, headOid, mergeRoute and what you may do to it. status: merge readiness and checks, with the version, headOid and baseOid merge_pull_request needs. reviews, commits, files, comments: one page each; files carries the version and paths get_pull_request_diff takes, comments the IDs and versions add_comment and update_comment take. merge_status: a merge operation's outcome; poll an accepted merge with backoff, as accepted is not completed. Take the number from list_pull_requests or a create_pull_request receipt.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "pull",
      "facet"
    ],
    "properties": {
      "pull": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The pull request's number within the repository (the 42 of #42), from list_pull_requests or a create_pull_request receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "after": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]+$",
        "maxLength": 8192,
        "minLength": 1,
        "description": "For reviews, comments, commits or files: next from the previous page; omit for the first page. For files, pass expectedVersion with it."
      },
      "facet": {
        "enum": [
          "detail",
          "reviews",
          "commits",
          "files",
          "status",
          "comments",
          "merge_status"
        ],
        "type": "string",
        "description": "detail: the pull request, with its version, headOid, observedBaseOid, mergeRoute and your capabilities. reviews: one page of submitted reviews, oldest first. commits: one page of its commits, newest first. files: one page of changed files, whose paths get_pull_request_diff reads. status: merge readiness and checks, with the version, headOid and baseOid merge_pull_request needs. comments: one page of conversation and inline comments, with IDs, thread IDs and versions. merge_status: the state of a merge, identified by operationId."
      },
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 50,
        "minimum": 1,
        "description": "How many reviews, commits, files or comments to return in this page; other facets ignore it."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "filter": {
        "enum": [
          "all",
          "general",
          "inline"
        ],
        "type": "string",
        "default": "all",
        "description": "For comments: general lists comments not on a file, inline lists comments on a file or line, all lists both."
      },
      "operationId": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "string",
            "pattern": "^ghd_[0-9a-f]{64}$"
          }
        ],
        "description": "For merge_status: the id returned by merge_pull_request."
      },
      "expectedVersion": {
        "type": "integer",
        "maximum": 2147483646,
        "minimum": 0,
        "description": "For commits or files: the pull request version the page must match (version from an earlier commits, files or detail read); the read fails if the pull request changed since. Omit to read the current version."
      }
    },
    "additionalProperties": false
  }

  arguments 84 lines copy
• get_pull_request_diff auth-required never probed

  Read the patch of chosen changed files of a pull request, pinned to the version the files were listed at. Each file comes with its hunks and line origins; a binary or too-large file has no hunks, and hunksOmitted marks a file whose hunks did not fit the response, so request fewer paths. Take paths and expectedVersion from pull_request_read facet files; the line numbers are what add_comment target pull_inline anchors to.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "pull",
      "paths",
      "expectedVersion"
    ],
    "properties": {
      "pull": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The pull request's number within the repository (the 42 of #42), from list_pull_requests or a create_pull_request receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "paths": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 4096,
          "minLength": 1
        },
        "maxItems": 64,
        "minItems": 1,
        "description": "The changed files to read, by their path from pull_request_read facet files (the new path of a renamed file), each once; fewer paths leave more room for hunks."
      },
      "expectedVersion": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": 0,
        "description": "The version pull_request_read facet files returned with those paths; the read fails if the pull request changed since, so list the files again."
      }
    },
    "additionalProperties": false
  }

  arguments 47 lines copy
• create_issue auth-required never probed

  Create an issue in a repository with a title and, optionally, a description, priority, due date, workflow state, labels, assignees and a milestone. Returns the new issue's number and the version its next write takes. Take label, assignee and milestone IDs from the issues list_issues or issue_read return, and your own actorId from get_me. There is no idempotency key: on an unknown outcome, list_issues before trying again rather than retrying automatically.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "title"
    ],
    "properties": {
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "state": {
        "enum": [
          "triage",
          "backlog",
          "unstarted",
          "started"
        ],
        "type": "string",
        "description": "The workflow state to start in; omit for backlog."
      },
      "title": {
        "type": "string",
        "maxLength": 255,
        "minLength": 1,
        "description": "The issue's heading: a short summary of the work or problem."
      },
      "dueDate": {
        "anyOf": [
          {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
          },
          {
            "type": "null"
          }
        ],
        "description": "When the issue is due, as a date-time such as 2026-08-01T00:00:00Z; omit or null for no due date."
      },
      "labelIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "maxItems": 100,
        "description": "IDs of the labels to apply. No tool lists a repository's labels; reuse the label IDs that list_issues and issue_read show on issues."
      },
      "priority": {
        "type": "integer",
        "maximum": 4,
        "minimum": 0,
        "description": "How urgent the issue is: 1 urgent, 2 high, 3 medium, 4 low, 0 none. Omit for none."
      },
      "assigneeIds": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "maxItems": 20,
        "description": "Actor IDs of the people to assign, not handles: get_me returns your own actorId, and issues show their assignees' IDs."
      },
      "description": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 65536
          },
          {
            "type": "null"
          }
        ],
        "description": "The issue's body, in Markdown; omit or null for none."
      },
      "milestoneId": {
        "type": [
          "string",
          "null"
        ],
        "description": "ID of the milestone to add the issue to, as list_issues and issue_read show on issues; omit or null for none."
      }
    },
    "additionalProperties": false
  }

  arguments 92 lines copy
• update_issue auth-required never probed

  Change one issue, one action per call: edit its title, description, priority, due date or open workflow state; close it as completed or canceled; or reopen it. Returns the version the next write takes. Take the number and current version from issue_read, list_issues or the last receipt; the write fails if the issue changed since. An edit overwrites the previous values, which are not kept; title, description and open/closed changes also reach a linked GitHub issue. Labels, assignees and milestones cannot be changed with these tools.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "issue",
      "action",
      "input"
    ],
    "properties": {
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "input": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "expectedVersion"
            ],
            "properties": {
              "state": {
                "enum": [
                  "triage",
                  "backlog",
                  "unstarted",
                  "started"
                ],
                "type": "string",
                "description": "The new open workflow state; setting one on a closed issue reopens it."
              },
              "title": {
                "type": "string",
                "maxLength": 255,
                "minLength": 1,
                "description": "The new heading; omit to keep the current one."
              },
              "dueDate": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The new due date-time; null clears it, omit keeps it."
              },
              "priority": {
                "type": "integer",
                "maximum": 4,
                "minimum": 0,
                "description": "How urgent the issue is: 1 urgent, 2 high, 3 medium, 4 low, 0 none. Omit to keep the current one."
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 65536
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The new body, in Markdown; null clears it, omit keeps it."
              },
              "expectedVersion": {
                "type": "integer",
                "maximum": 2147483646,
                "minimum": 0,
                "description": "The issue's current version, from issue_read, list_issues or the last receipt; the write fails if the issue changed since, so read it again and retry."
              }
            },
            "description": "For action edit: expectedVersion and at least one field to change.",
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "expectedVersion"
            ],
            "properties": {
              "state": {
                "enum": [
                  "completed",
                  "canceled"
                ],
                "type": "string",
                "default": "completed",
                "description": "completed: the work is done. canceled: it will not be done. Omit for completed."
              },
              "reason": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 1024
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Why the issue is being closed, stored on the issue; it is not posted as a comment."
              },
              "expectedVersion": {
                "type": "integer",
                "maximum": 2147483646,
                "minimum": 0,
                "description": "The issue's current version, from issue_read, list_issues or the last receipt; the write fails if the issue changed since, so read it again and retry."
              }
            },
            "description": "For action close.",
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "expectedVersion"
            ],
            "properties": {
              "expectedVersion": {
                "type": "integer",
                "maximum": 2147483646,
                "minimum": 0,
                "description": "The issue's current version, from issue_read, list_issues or the last receipt; the write fails if the issue changed since, so read it again and retry."
              }
            },
            "description": "For action reopen.",
            "additionalProperties": false
          }
        ],
        "description": "Shape depends on action; each option says when it applies."
      },
      "issue": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The issue's number within the repository (the 42 of #42), from list_issues or a create_issue receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "action": {
        "enum": [
          "edit",
          "close",
          "reopen"
        ],
        "type": "string",
        "description": "edit: change the fields in input. close: close the issue as completed or canceled. reopen: reopen a closed issue into backlog."
      }
    },
    "additionalProperties": false
  }

  arguments 160 lines copy
• add_comment auth-required never probed

  Post one comment, by target: on an issue; in a pull request's conversation; inline on a file or lines of a pull request's diff, anchored to an exact commit; or as a reply in an existing pull request thread, which inherits the thread's anchor. Returns the comment's id and version for update_comment, and for a pull request comment its threadId. For an inline comment take path and the commit (headOid for the right side and file comments, comparisonBaseOid for the left side) from pull_request_read facet files; for a reply take replyTo from facet comments. There is no idempotency key: on an unknown outcome, read the comments before trying again rather than retrying automatically.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "target",
      "input"
    ],
    "properties": {
      "pull": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The pull request's number within the repository (the 42 of #42), from list_pull_requests or a create_pull_request receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "input": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "body"
            ],
            "properties": {
              "body": {
                "type": "string",
                "maxLength": 65536,
                "minLength": 1,
                "description": "What the comment says, in Markdown."
              }
            },
            "description": "For targets issue, pull and pull_reply: the comment.",
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "body",
              "path",
              "line",
              "commitOid"
            ],
            "properties": {
              "body": {
                "type": "string",
                "maxLength": 65536,
                "minLength": 1,
                "description": "What the comment says, in Markdown."
              },
              "line": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 2147483647,
                    "minimum": 1
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The commented line, or the last line of a commented range, numbered in the side's version of the file."
              },
              "path": {
                "type": "string",
                "maxLength": 4096,
                "minLength": 1,
                "description": "The commented file, by its path in pull_request_read facet files (relative to the repository root)."
              },
              "side": {
                "anyOf": [
                  {
                    "enum": [
                      "left",
                      "right"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": "right",
                "description": "Which version of the file the line numbers count in. left: the old version (removed lines). right: the new version (added and unchanged lines)."
              },
              "commitOid": {
                "type": "string",
                "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$",
                "description": "The commit the line numbers refer to, from pull_request_read facet files: headOid for right-side and file comments, comparisonBaseOid (the merge base) for left-side comments."
              },
              "startLine": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 2147483647,
                    "minimum": 1
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The first line of a commented range; omit to comment on one line."
              },
              "startSide": {
                "anyOf": [
                  {
                    "enum": [
                      "left",
                      "right"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The side startLine counts in; set it together with startLine."
              },
              "subjectType": {
                "enum": [
                  "line",
                  "file"
                ],
                "type": "string",
                "description": "line: the comment is on a line or a range of lines (the default). file: the comment is on the whole file; then pass line and side as null."
              }
            },
            "description": "For target pull_inline: the comment and where it is anchored.",
            "additionalProperties": false
          }
        ],
        "description": "Shape depends on target; each option says when it applies."
      },
      "issue": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The issue's number within the repository (the 42 of #42), from list_issues or a create_issue receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "target": {
        "enum": [
          "issue",
          "pull",
          "pull_inline",
          "pull_reply"
        ],
        "type": "string",
        "description": "issue: a comment on the issue numbered issue. pull: a conversation comment on the pull request numbered pull. pull_inline: a comment on a file or on lines of that pull request's diff. pull_reply: a reply in the thread of comment replyTo on that pull request; it inherits the thread's anchor."
      },
      "replyTo": {
        "type": "string",
        "description": "ID of any comment in the thread to reply in, from pull_request_read facet comments or an add_comment receipt."
      }
    },
    "additionalProperties": false
  }

  arguments 165 lines copy
• merge_pull_request auth-required never probed

  Merge a pull request into its target branch with an explicit strategy, at the exact head, base and version you reviewed. Returns a merge operation: accepted is admitted but not merged yet, completed is merged, failed is not merged. Take headOid, baseOid and expectedVersion from pull_request_read facet status, and which strategies are allowed from its merge verdict; follow an accepted operation with facet merge_status, with backoff. A merge cannot be undone with these tools. On an unknown outcome, retry with the same requestId and input, never with a new key; a different input under the same requestId is rejected.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "pull",
      "requestId",
      "expectedVersion",
      "headOid",
      "baseOid",
      "strategy"
    ],
    "properties": {
      "pull": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The pull request's number within the repository (the 42 of #42), from list_pull_requests or a create_pull_request receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "baseOid": {
        "type": "string",
        "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$",
        "description": "The target branch commit you reviewed: baseOid from facet status, or observedBaseOid from detail. Not the merge base."
      },
      "headOid": {
        "type": "string",
        "pattern": "^(?:[a-f0-9]{40}|[a-f0-9]{64})$",
        "description": "The head commit you reviewed: headOid from pull_request_read facet status or detail."
      },
      "strategy": {
        "enum": [
          "fast-forward",
          "merge",
          "squash",
          "rebase"
        ],
        "type": "string",
        "description": "fast-forward: move the target branch to the head, adding no commit (not for pull requests whose detail mergeRoute is provider). merge: add a merge commit. squash: add one commit with all the changes. rebase: replay the commits onto the target branch."
      },
      "requestId": {
        "type": "string",
        "pattern": "^[!-~]+$",
        "maxLength": 96,
        "minLength": 1,
        "description": "Your stable key for this merge. Retrying with the same key and input returns the original operation; different input with the same key is rejected."
      },
      "expectedVersion": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": 0,
        "description": "The pull request version you reviewed, from pull_request_read facet status or detail. The merge fails if it changed since."
      }
    },
    "additionalProperties": false
  }

  arguments 66 lines copy
• create_pull_request auth-required never probed

  Open a pull request that merges a source branch of this repository or a fork into a target branch, with a title and optional description. Returns the new pull request's number and the version its next write takes. Take sourceRepo from get_repository (the fork's id, or this repository's) and the branch names from list_refs; the source branch must already be pushed with git or the Cafe CLI, as these tools cannot push. With a stable submissionKey, retrying after an unknown outcome returns the original pull request instead of a duplicate; without one, list_pull_requests before trying again rather than retrying automatically.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "sourceRepo",
      "source",
      "target",
      "title"
    ],
    "properties": {
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "title": {
        "type": "string",
        "maxLength": 1000,
        "minLength": 1,
        "description": "The pull request's heading: a short summary of the change."
      },
      "source": {
        "type": "string",
        "maxLength": 255,
        "description": "Short name of the branch with the changes, already pushed to sourceRepo, e.g. fix-login."
      },
      "target": {
        "type": "string",
        "maxLength": 255,
        "description": "Short name of the branch in owner/repo to merge into, e.g. main."
      },
      "sourceRepo": {
        "type": "string",
        "description": "ID (repo_...) of the repository holding the source branch: this repository or a fork of it. get_repository returns a repository's id."
      },
      "description": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 65536
          },
          {
            "type": "null"
          }
        ],
        "description": "The pull request's body, in Markdown; omit or null for none."
      },
      "submissionKey": {
        "type": "string",
        "maxLength": 255,
        "minLength": 1,
        "description": "Your stable key for this pull request. Retrying with the same key and input returns the original pull request instead of a duplicate; different input with the same key is rejected."
      }
    },
    "additionalProperties": false
  }

  arguments 63 lines copy
• submit_review auth-required never probed

  Submit a review of a pull request at an exact commit and version: approve, request changes, or comment without a decision, with an optional overall body. Returns the review with its id, verdict and commit. Take commitOid (headOid) and expectedVersion from pull_request_read facet detail or status; the review fails if the pull request changed since, so read again and resubmit at the new head. To publish a draft review you saved in the GitCafe web UI, with its inline comments, pass its id and version as draft with the same verdict, body and commit it was saved with; these tools cannot create or read drafts. Approving or requesting changes on your own pull request is refused, and a submitted review cannot be withdrawn with these tools. On an unknown outcome, retry with the same requestId and input, which returns the original review; a different input under the same requestId is rejected.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "pull",
      "verdict",
      "commitOid",
      "expectedVersion",
      "requestId"
    ],
    "properties": {
      "body": {
        "type": "string",
        "maxLength": 65536,
        "description": "The review's overall comment, in Markdown, shown with the verdict; omit for none."
      },
      "pull": {
        "type": "integer",
        "maximum": 2147483647,
        "description": "The pull request's number within the repository (the 42 of #42), from list_pull_requests or a create_pull_request receipt; not its ID.",
        "exclusiveMinimum": 0
      },
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "draft": {
        "type": "object",
        "required": [
          "id",
          "version"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "ID (review_...) of your saved draft review on this pull request."
          },
          "version": {
            "type": "integer",
            "maximum": 2147483646,
            "minimum": 0,
            "description": "The draft's current version."
          }
        },
        "description": "A draft review you saved in the GitCafe web UI, to publish with its inline comments; pass the same verdict, body and commitOid it was saved with. These tools cannot create or read drafts; omit to submit a new review.",
        "additionalProperties": false
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "verdict": {
        "enum": [
          "approve",
          "request_changes",
          "comment"
        ],
        "type": "string",
        "description": "approve or request_changes records a decision and is not allowed on your own pull request; comment gives feedback without one."
      },
      "commitOid": {
        "type": "string",
        "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$",
        "description": "The head commit you reviewed: headOid from pull_request_read facet detail or status."
      },
      "requestId": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]+$",
        "maxLength": 128,
        "minLength": 1,
        "description": "Your stable key for this review. Retrying with the same key and input returns the original review; different input with the same key is rejected."
      },
      "expectedVersion": {
        "type": "integer",
        "maximum": 2147483646,
        "minimum": 0,
        "description": "The pull request version you reviewed, from pull_request_read facet detail or status. The review fails if it changed since."
      }
    },
    "additionalProperties": false
  }

  arguments 85 lines copy
• ci_read unknown 2h ago

  Read a repository's CI, one facet per call. runs: one page of Buildkite runs, newest first, narrowed by commit or state. run: one run by runId. checks: one page of the checks on a commit, with a summary over all of them. jobs: one page of a run's jobs. log: the end of a job's log. Runs, run and checks read what GitCafe recorded, including GitHub checks on a linked repository; jobs and log read Buildkite live and need the repository owner to have shared logs. Take the commit from pull_request_read (headOid) or list_refs, runId from a run or check, and jobId from facet jobs. Long text fields are cut to fit, and truncatedFields names them. CI cannot be started, rerun or cancelled with these tools.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182

  {
    "type": "object",
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "required": [
      "owner",
      "repo",
      "facet"
    ],
    "properties": {
      "repo": {
        "type": "string",
        "maxLength": 104,
        "description": "The repository's name within that owner: website for the repository acme/website. list_repositories and get_repository return both parts."
      },
      "after": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_-]+$",
        "maxLength": 8192,
        "minLength": 1,
        "description": "For runs, checks or jobs: next from the previous page; omit for the first page."
      },
      "facet": {
        "enum": [
          "runs",
          "run",
          "checks",
          "jobs",
          "log"
        ],
        "type": "string",
        "description": "runs: one page of the repository's CI runs, newest first. run: one run, by runId. checks: one page of the checks reported on a commit, with a summary of all of them. jobs: one page of the jobs of run runId. log: the end of job jobId's log in run runId."
      },
      "jobId": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
        "description": "For log: the job's id from facet jobs; only a job whose logAvailable is true has a log."
      },
      "limit": {
        "type": "integer",
        "default": 30,
        "maximum": 100,
        "minimum": 1,
        "description": "For runs: how many runs to return in this page; omit for the default page size."
      },
      "owner": {
        "type": "string",
        "pattern": "^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,38}$",
        "description": "The user or organization that owns the repository: acme for the repository acme/website."
      },
      "runId": {
        "type": "string",
        "description": "ID (cirun_...) of the run: id of a runs item, runId of a checks item, or ciRunId of a pull_request_read status check. Not the provider's build number."
      },
      "state": {
        "enum": [
          "queued",
          "running",
          "blocked",
          "passed",
          "failed",
          "canceled",
          "errored"
        ],
        "type": "string",
        "description": "For runs: only runs in this state. queued: not started. running: in progress. blocked: paused on a manual step. passed, failed, canceled, errored: finished that way."
      },
      "commit": {
        "type": "string",
        "pattern": "^[0-9a-f]{40}$",
        "description": "The commit, as a 40-character hexadecimal OID: headOid from pull_request_read, or oid from list_refs. For checks, the commit to read; for runs, only runs of this commit."
      },
      "tailBytes": {
        "type": "integer",
        "default": 16384,
        "maximum": 24576,
        "minimum": 1,
        "description": "For log: how many bytes from the end of the log to return; omit for the default. The result's startByte says where the excerpt begins."
      }
    },
    "additionalProperties": false
  }

  arguments 82 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.