# CircleCI AI integration on Definable

> CircleCI is a continuous integration and delivery platform that automates build, test, and deployment pipelines for software development.

## What this connects

CircleCI is a continuous integration and delivery platform that automates build, test, and deployment pipelines for software development.

Vendor: https://circleci.com/

## Tools available

**65** tools available. First 12:

- `CIRCLECI_CREATE_CONTEXT` — Create Context — Tool to create a new context in CircleCI. Contexts are used to secure and share environment variables across projects. Use this when you need to set up a new environment configuration for your CircleCI workflows.
- `CIRCLECI_CREATE_CONTEXT_GRAPHQL` — Create Context (GraphQL) — Tool to create a new CircleCI context using the GraphQL API. Use when you need to create a context for storing environment variables in CircleCI. The mutation returns error information if creation fails or payload data if successful.
- `CIRCLECI_CREATE_CONTEXT_RESTRICTION` — Create Context Restriction — Tool to create a context restriction in CircleCI. Use when you need to limit context access based on project, expression rules, or group membership.
- `CIRCLECI_CREATE_ORGANIZATION_ORB_ALLOWLIST` — Create Organization Orb Allowlist — Tool to create a new URL Orb allow-list entry for an organization. Use when you need to allow URL-based orb references from specific URL prefixes in CircleCI pipelines for an organization.
- `CIRCLECI_CREATE_ORGANIZATION_PROJECT` — Create Organization Project — Tool to create a new project within a CircleCI organization. Use when you need to programmatically set up a new project for CI/CD automation.
- `CIRCLECI_CREATE_ORG_GROUP` — Create Organization Group — Tool to create a group in an organization. Use when you need to organize users within a CircleCI organization by creating logical groups.
- `CIRCLECI_CREATE_PROJECT_ENV_VAR` — Create Project Environment Variable — Tool to create a new environment variable for a CircleCI project. Use when you need to add a new environment variable that will be available in project builds.
- `CIRCLECI_CREATE_USAGE_EXPORT_JOB` — Create Usage Export Job — Tool to create a usage export job for a CircleCI organization. Use when you need to export usage data for billing, analysis, or reporting purposes. Rate limited to 10 queries per hour. Maximum date window is 32 days, with up to 13 months of historical data available.
- `CIRCLECI_DELETE_CONTEXT_GRAPHQL` — Delete Context (GraphQL) — Tool to delete a CircleCI context by its UUID using GraphQL API. Use when you need to permanently remove a context from your CircleCI organization. This action is irreversible and will delete all environment variables associated with the context.
- `CIRCLECI_DELETE_CONTEXT_RESTRICTION` — Delete Context Restriction — Tool to delete a context restriction by its ID. Use when you need to remove a specific restriction from a CircleCI context.
- `CIRCLECI_DELETE_NAMESPACE` — Delete Namespace and Related Orbs — Tool to delete a CircleCI registry namespace and all its associated orbs. Use when you need to permanently remove a namespace from the registry. This is a destructive operation that cannot be undone.
- `CIRCLECI_DELETE_NAMESPACE_ALIAS` — Delete Namespace Alias — Tool to remove a namespace alias by name in CircleCI. Use when you need to delete an existing namespace alias that is no longer needed. The mutation returns a boolean indicating success and any errors that occurred during deletion.

## Auth

Auth schemes: `API_KEY`.

## How agents use CircleCI

Inside a Definable workflow, CircleCI is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → CircleCI** — the Researcher (GPT-5.5) pulls context from CircleCI (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → CircleCI** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into CircleCI (create record, post message, draft email).
- **Designer / Engineer → Distributor → CircleCI** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via CircleCI (attach file, open PR comment, post status).

The Verifier checks every CircleCI call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/circleci/
- Same category (developer tools): https://definable.ai/apps/category/developer-tools/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt