CircleCI

CircleCI's hosted MCP server helps inspect pipelines, builds, tests, failures, and delivery workflows.

Connection specification

Remote endpoint
https://mcp.circleci.com/v1/mcp
Browser access
Not yet measured
Declared MCP transport
Streamable HTTP
Live-validated MCP transport
Not yet verified — Latest validation did not verify a transport
Declared authentication
OAuth 2.1
Detected authentication
OAuth 2.1 detected or retained from publisher evidence
Alternative authentication
Bearer token
Protocol lifecycle
Not yet negotiated
Required header
Authorization — Optional personal API token alternative: Bearer <CIRCLECI_PERSONAL_API_TOKEN>
Authorization server
https://app.circleci.com
Category
Developer Tools

Product documentation · Source repository · Official listing documentation

Provider guidance

  • The CircleCI hosted MCP service is in preview. OAuth is recommended, with a personal API token supported as an alternative.

Browse all MCP servers · Test this endpoint in the MCP Playground

Authorization setup

Registration requirements not verified

The OAuth authorization and app-registration requirements for this exact endpoint have not been verified. A compatible client will request authorization, but follow the publisher documentation and do not guess client credentials or callbacks.

Publisher evidence reviewed .

Publisher documentation

Connect this server to your client

Claude Code setup

Run in a terminal. This user-scoped entry is available across projects.

claude mcp add --transport http --scope user 'circleci' 'https://mcp.circleci.com/v1/mcp'

Registration requirements not verified: The OAuth authorization and app-registration requirements for this exact endpoint have not been verified. A compatible client will request authorization, but follow the publisher documentation and do not guess client credentials or callbacks.

  • Using live-validated endpoint: https://mcp.circleci.com/v1/mcp
  • Registration requirements not verified: The OAuth authorization and app-registration requirements for this exact endpoint have not been verified. A compatible client will request authorization, but follow the publisher documentation and do not guess client credentials or callbacks.
  • Publisher evidence (reviewed 2026-08-24): https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/
  • Optional bearer token alternative: Store CIRCLECI_PERSONAL_API_TOKEN in your operating system keychain, secret manager, or protected environment; never commit the value. The Authorization header syntax is Bearer <CIRCLECI_PERSONAL_API_TOKEN>.
  • Provider guidance: The CircleCI hosted MCP service is in preview. OAuth is recommended, with a personal API token supported as an alternative.
  • After adding the server, open Claude Code, run /mcp, select the server, and follow the browser flow to authenticate.

Claude Code MCP documentation

Codex CLI setup

Run in a terminal; Codex stores the entry in ~/.codex/config.toml.

codex mcp add 'circleci' --url 'https://mcp.circleci.com/v1/mcp'
codex mcp login 'circleci'

Registration requirements not verified: The OAuth authorization and app-registration requirements for this exact endpoint have not been verified. A compatible client will request authorization, but follow the publisher documentation and do not guess client credentials or callbacks.

  • Using live-validated endpoint: https://mcp.circleci.com/v1/mcp
  • Registration requirements not verified: The OAuth authorization and app-registration requirements for this exact endpoint have not been verified. A compatible client will request authorization, but follow the publisher documentation and do not guess client credentials or callbacks.
  • Publisher evidence (reviewed 2026-08-24): https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/
  • Optional bearer token alternative: Store CIRCLECI_PERSONAL_API_TOKEN in your operating system keychain, secret manager, or protected environment; never commit the value. The Authorization header syntax is Bearer <CIRCLECI_PERSONAL_API_TOKEN>.
  • Provider guidance: The CircleCI hosted MCP service is in preview. OAuth is recommended, with a personal API token supported as an alternative.

Codex MCP documentation

Cursor setup

Add to .cursor/mcp.json for this project, or ~/.cursor/mcp.json for all projects.

{
  "mcpServers": {
    "circleci": {
      "url": "https://mcp.circleci.com/v1/mcp"
    }
  }
}

Registration requirements not verified: The OAuth authorization and app-registration requirements for this exact endpoint have not been verified. A compatible client will request authorization, but follow the publisher documentation and do not guess client credentials or callbacks.

  • Using live-validated endpoint: https://mcp.circleci.com/v1/mcp
  • Registration requirements not verified: The OAuth authorization and app-registration requirements for this exact endpoint have not been verified. A compatible client will request authorization, but follow the publisher documentation and do not guess client credentials or callbacks.
  • Publisher evidence (reviewed 2026-08-24): https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/
  • Optional bearer token alternative: Store CIRCLECI_PERSONAL_API_TOKEN in your operating system keychain, secret manager, or protected environment; never commit the value. The Authorization header syntax is Bearer <CIRCLECI_PERSONAL_API_TOKEN>.
  • Provider guidance: The CircleCI hosted MCP service is in preview. OAuth is recommended, with a personal API token supported as an alternative.

Cursor MCP documentation

VS Code setup

Add to .vscode/mcp.json, or run “MCP: Open User Configuration” for a private user-level entry.

{
  "servers": {
    "circleci": {
      "type": "http",
      "url": "https://mcp.circleci.com/v1/mcp"
    }
  }
}

Registration requirements not verified: The OAuth authorization and app-registration requirements for this exact endpoint have not been verified. A compatible client will request authorization, but follow the publisher documentation and do not guess client credentials or callbacks.

  • Using live-validated endpoint: https://mcp.circleci.com/v1/mcp
  • Registration requirements not verified: The OAuth authorization and app-registration requirements for this exact endpoint have not been verified. A compatible client will request authorization, but follow the publisher documentation and do not guess client credentials or callbacks.
  • Publisher evidence (reviewed 2026-08-24): https://circleci.com/docs/guides/toolkit/circleci-mcp-overview/
  • Optional bearer token alternative: Store CIRCLECI_PERSONAL_API_TOKEN in your operating system keychain, secret manager, or protected environment; never commit the value. The Authorization header syntax is Bearer <CIRCLECI_PERSONAL_API_TOKEN>.
  • Provider guidance: The CircleCI hosted MCP service is in preview. OAuth is recommended, with a personal API token supported as an alternative.

VS Code MCP documentation

Latest validation evidence

Validation status
Online when last tested
Validation checked at
Aug 18, 2026 at 1:35 PM
Validation detail
Authentication challenge at https://mcp.circleci.com/v1/mcp returned HTTP 401; endpoint was reachable but did not complete an MCP probe; authentication oauth