Get started

CircleCI for AI agents

CircleCI runs continuous integration and delivery pipelines, automating the build, test, and deploy steps a team would otherwise run by hand. Connect it once through Arc0, and your agent, or Claude, ChatGPT and Cursor, can use it through one MCP endpoint, limited to what each user approved.

Connect CircleCISee the 65 actions ↓
Developer toolsAPI keyMCP + RESTcircleci.com
AUDIT LOG · CIRCLECIPOLICY: acme-support
09:41:07 · claude · u_8f2read
circleci.list_orbs
List Orbs✓ allowed · 212ms
09:41:08 · claude · u_8f2read
circleci.get_context
Get Context✓ allowed · 164ms
09:41:09 · claude · u_8f2write
circleci.create_context
Create Context✓ approved · approved by user
09:41:12 · claude · u_8f2destructive
circleci.delete_project
Delete Project✕ blocked · policy: deny
EVERY CIRCLECI CALL, ON THE RECORD
01 · USE CASES

What agents do in CircleCI.

01

Check a pipeline's job details

Check a job's details and logs to see why a build failed.

02

Pull job artifacts

Pull the artifacts from a completed job, such as a build output or test report.

03

Confirm before deleting a project

Confirm before deleting a project from an organization, since its pipeline history goes with it.

02 · ACTIONS

65 CircleCI actions, graded by risk.

Every CircleCI action is tagged read, write or destructive, so one policy covers the whole app and new actions inherit the right default.

read

44

Look things up. Allowed by default.

  • circleci.list_orbs
    List Orbs
  • circleci.get_context
    Get Context
  • circleci.get_project
    Get Project
  • circleci.query_orb_id
    Query Orb ID
  • circleci.query_context
    Query Context
  • circleci.list_pipelines
    List Pipelines
  • circleci.get_flaky_tests
    Get Flaky Tests
  • circleci.get_job_details
    Get Job Details
  • circleci.get_orb_details
    Get Orb Details
  • circleci.get_orb_version
    Get Orb Version
  • circleci.get_current_user
    Get Current User
  • circleci.get_organization
    Get Organization
  • circleci.query_orb_exists
    Query Orb Exists
  • circleci.query_orb_source
    Query Orb Source
  • circleci.get_job_artifacts
    Get Job Artifacts
  • circleci.get_test_metadata
    Get Test Metadata
+ 28 MORE

write

12

Create and change things. Allow, or ask the user first.

  • circleci.create_context
    Create Context
  • circleci.create_org_group
    Create Organization Group
  • circleci.create_context_graphql
    Create Context (GraphQL)
  • circleci.create_project_env_var
    Create Project Environment Variable
  • circleci.create_usage_export_job
    Create Usage Export Job
  • circleci.create_context_restriction
    Create Context Restriction
  • circleci.create_organization_project
    Create Organization Project
  • circleci.create_organization_orb_allowlist
    Create Organization Orb Allowlist
  • circleci.rename_namespace
    Rename Namespace
  • circleci.trigger_pipeline
    Trigger Pipeline
  • circleci.upsert_context_env_var
    Upsert Context Environment Variable
  • circleci.store_environment_variable
    Store Environment Variable

destructive

9

Delete, cancel or archive. Ask first, or deny outright.

  • circleci.delete_project
    Delete Project
  • circleci.delete_namespace
    Delete Namespace and Related Orbs
  • circleci.delete_org_group
    Delete Organization Group
  • circleci.delete_context_graphql
    Delete Context (GraphQL)
  • circleci.delete_namespace_alias
    Delete Namespace Alias
  • circleci.delete_project_env_var
    Delete Project Environment Variable
  • circleci.delete_context_restriction
    Delete Context Restriction
  • circleci.remove_context_env_var_graphql
    Remove Context Environment Variable (GraphQL)
  • circleci.delete_organization_orb_allowlist
    Delete Organization Orb Allowlist Entry
03 · HOW IT WORKS

CircleCI in three steps.

  1. 01Your users connect CircleCIThey add their CircleCI api key on Arc0 Connect, under your brand. It goes straight into the vault.
  2. 02You set the rulesReads run, writes like “create Context” can wait for the user, and “delete Project” can be denied outright.
  3. 03Any agent can actYour agent calls CircleCI through the Arc0 SDK or MCP, and so can Claude, ChatGPT and Cursor. Every call lands on the audit log.
POLICY.TS
await arc0.policies.set('circleci', {
  read: 'allow',
  write: 'ask',        // create_context
  destructive: 'deny',  // delete_project
})

# Claude Code: the same connection, one URL
$ claude mcp add --transport http arc0 \
    https://mcp.arc0.ai/u/u_8f2
04 · AUTH AND DATA

How CircleCI connects.

Users add their CircleCI api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

The same CircleCI connection serves your agent over MCP and your own backend over REST and the proxy, so a user connects once. How Arc0 handles credentials →

AUTH
API key
CREDENTIALS
Per-tenant encrypted vault
MODEL SEES
Results only, never credentials
AUDIT LOG
Every call, on every plan
05 · WORKS WITH

Use CircleCI from any agent.

Claude
ChatGPT
Cursor
Codex
VS Code
OpenAI Agents SDK
Claude Agent SDK
Vercel AI SDK
Mastra
LangGraph
06 · RELATED

More developer tools apps.

GitHub896 actionsSupabase129 actions0CodeKit8 actionsAbly25 actionsAbstract3 actionsAddressfinder17 actionsAddresszen2 actionsAlchemy36 actions
ALL DEVELOPER TOOLS APPS →
07 · FAQ

CircleCI and Arc0, answered.

Q01

Can I use CircleCI with Claude, ChatGPT or Cursor?

Yes. Connect CircleCI to Arc0 once, then add your Arc0 MCP URL to Claude, ChatGPT, Cursor, Claude Code or any other remote-MCP client. Each assistant only gets the CircleCI actions you allow.

Q02

How do users connect CircleCI?

Users add their CircleCI api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

Q03

Which CircleCI actions can my agent take?

65 in total: 44 read, 12 write and 9 destructive, such as “create Context”. Your policies decide which of them each agent may call.

Q04

Can I stop my agent from deleting things in CircleCI?

Yes. Actions like “delete Project” are graded destructive. Set destructive actions to deny, or to ask so the user approves each one, and blocked calls still show up on the audit log.

Q05

Can my own backend call CircleCI too?

Yes. The same CircleCI connection is available over REST and through the Arc0 proxy, so your product and your agent share one connection per user.

Get started

Plug CircleCI into your agent.

Your users connect CircleCI once, under your brand. Your agent gets 65 actions behind your policies, with every call on the record.

Connect CircleCIBrowse all apps →

Free to build · MCP + REST · Audit log on every plan