get_build_failure_logs

Retrieve and analyze CircleCI build failure logs by providing a project URL or workspace details. Use a direct URL or specify workspace root, Git remote URL, and branch to debug builds efficiently.

Instructions

This tool helps debug CircleCI build failures by retrieving failure logs.

Input options (EXACTLY ONE of these two options must be used):

Option 1 - Direct URL (provide ONE of these):
- projectURL: The URL of the CircleCI project in any of these formats:
  * Project URL: https://app.circleci.com/pipelines/gh/organization/project
  * Pipeline URL: https://app.circleci.com/pipelines/gh/organization/project/123
  * Workflow URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def
  * Job URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz

Option 2 - Project Detection (ALL of these must be provided together):
- workspaceRoot: The absolute path to the workspace root
- gitRemoteURL: The URL of the git remote repository
- branch: The name of the current branch

IMPORTANT:
- Never call this tool with incomplete parameters
- If using Option 1, the URLs MUST be provided by the user - do not attempt to construct or guess URLs
- If using Option 2, ALL THREE parameters (workspaceRoot, gitRemoteURL, branch) must be provided
- If neither option can be fully satisfied, ask the user for the missing information before making the tool call

Input Schema

Name	Required	Description	Default
`params`	Yes

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "params": {
      "additionalProperties": false,
      "properties": {
        "branch": {
          "description": "The name of the branch currently checked out in local workspace. This should match local git branch. For example: \"feature/my-branch\", \"bugfix/123\", \"main\", \"master\" etc.",
          "type": "string"
        },
        "gitRemoteURL": {
          "description": "The URL of the remote git repository. This should be the URL of the repository that you cloned to your local workspace. For example: \"https://github.com/user/my-project.git\"",
          "type": "string"
        },
        "projectURL": {
          "description": "The URL of the CircleCI project. Can be any of these formats:\n- Project URL with branch: https://app.circleci.com/pipelines/gh/organization/project?branch=feature-branch\n- Pipeline URL: https://app.circleci.com/pipelines/gh/organization/project/123\n- Workflow URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def\n- Job URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz",
          "type": "string"
        },
        "workspaceRoot": {
          "description": "The absolute path to the root directory of your project workspace. This should be the top-level folder containing your source code, configuration files, and dependencies. For example: \"/home/user/my-project\" or \"C:\\Users\\user\\my-project\"",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "required": [
    "params"
  ],
  "type": "object"
}

mcp-server-circleci

get_build_failure_logs

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from mcp-server-circleci

Related Tools