---
title: "CircleCI integration for LuumenAI"
url: "https://www.luumen.ai/integrations/circleci/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# CircleCI integration for LuumenAI

Read CircleCI pipelines and jobs, then change contexts and env vars on approval

## What LuumenAI can do with CircleCI

LuumenAI connects to CircleCI with an API token and exposes 65 tools (45 read-only · 11 write · 9 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 65 tools (45 read-only · 11 write · 9 destructive)
- Plan: available on all plans
- Category: Source control & CI/CD

## About CircleCI with LuumenAI

Connect CircleCI and Luumen can read the state of your build and deploy pipelines from the terminal: job details, artifacts, pipeline configuration, flaky test history, contexts, and organization groups. Changes like creating a context, adding a project environment variable, or editing the orb allow-list are previewed and sent for approval before they run.

## Example tools

Read-only (45 in total):

- `CIRCLECI_CREATE_USAGE_EXPORT_JOB` — Create a usage export job for a CircleCI organization.
- `CIRCLECI_GET_CONTEXT` — Retrieve a context by its unique ID.
- `CIRCLECI_GET_CURRENT_USER` — Retrieve information about the currently authenticated user.
- `CIRCLECI_GET_FLAKY_TESTS` — Get flaky tests for a project.
- `CIRCLECI_GET_JOB_ARTIFACTS` — Retrieves artifacts (output files like test results, logs, build binaries, reports) produced by a CircleCI job.
- `CIRCLECI_GET_JOB_DETAILS` — Fetch details of a specific job within a project.
- `CIRCLECI_GET_ORB_DETAILS` — Query detailed information about a CircleCI orb using the GraphQL API.
- `CIRCLECI_GET_ORB_VERSION` — Retrieve detailed information about a specific CircleCI orb version via GraphQL.

Write and destructive (20 in total, approval required by default):

- `CIRCLECI_CREATE_CONTEXT` — Create a new context in CircleCI.
- `CIRCLECI_CREATE_CONTEXT_GRAPHQL` — Create a new CircleCI context using the GraphQL API.
- `CIRCLECI_CREATE_CONTEXT_RESTRICTION` — Create a context restriction in CircleCI.
- `CIRCLECI_CREATE_ORGANIZATION_ORB_ALLOWLIST` — Create a new URL Orb allow-list entry for an organization.
- `CIRCLECI_CREATE_ORGANIZATION_PROJECT` — Create a new project within a CircleCI organization.
- `CIRCLECI_CREATE_ORG_GROUP` — Create a group in an organization.
- `CIRCLECI_CREATE_PROJECT_ENV_VAR` — Create a new environment variable for a CircleCI project.
- `CIRCLECI_DELETE_CONTEXT_GRAPHQL` — Delete a CircleCI context by its UUID using GraphQL API.

## Frequently asked questions

### How does LuumenAI connect to CircleCI?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in CircleCI on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 9 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to CircleCI — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/circleci/