mcp-registry/mcp-server-circleci

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-server-circleci

by CircleCI-Public

Model-Context-Protocol (MCP) server that exposes CircleCI operations (e.g. get_build_failure_logs, run_pipeline) to AI/IDE clients.

58
28
Open Source
GitHub

Installation

1. Prerequisites:
• Node.js ≥ 18.x
• npm ≥ 9.x (or yarn/pnpm)
• A CircleCI personal API token with at least `status` scope
2. Clone the repository:
git clone https://github.com/CircleCI-Public/mcp-server-circleci.git cd mcp-server-circleci
3. Install dependencies:
npm install # or yarn install
4. Build the TypeScript source:
npm run build # compiles to ./dist
5. Configure environment variables (create a `.env` file or export vars):
CIRCLECI_TOKEN=<your-circleci-api-token> PORT=3000 # server listen port (default 3000) LOG_LEVEL=info # trace | debug | info | warn | error
6. Start the MCP server:
npm start # runs node dist/index.js
7. (Optional) Run the test suite and linter:
npm test npm run lint

Documentation

License: Other (NOASSERTION)
Updated 7/30/2025