Can I use CircleCI as a CLI?

Yes. KosmoKrator exposes a CircleCI CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose CircleCI through MCP?

Yes. The KosmoKrator MCP gateway can expose selected CircleCI tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are CircleCI credentials stored?

CircleCI credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for CircleCI MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

devtools

CircleCI MCP, CLI, and Lua Integration for AI Agents

CircleCI integration docs for AI agents: MCP gateway setup, CircleCI CLI commands, Lua API reference, credentials, and function schemas.

7 functions 6 read 1 write Bearer token auth

Submit CircleCI feedback View package source

CircleCI for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: circleci
route_slug: circleci
package: circleci
auth_strategy: bearer_token Bearer token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. CircleCI CLIHeadless setup and direct function calls. CircleCI MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

CircleCI MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for CircleCI.

CircleCI CLI Matrix

Use these pages for direct CircleCI CLI workflows in scripts, CI, cron, and agent wrappers.

CI CircleCI CLI for CI. Cron Jobs CircleCI CLI for cron jobs. Shell Scripts CircleCI CLI for shell scripts. Headless Automation CircleCI CLI for headless automation. Coding Agents CircleCI CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`circleci.circleci_list_pipelines`	Read `read`	4	List recent CI/CD pipelines in CircleCI. Filter by organization slug and branch. Returns pipeline IDs, status, trigger information, and revision details.
`circleci.circleci_get_pipeline`	Read `read`	1	Get detailed information about a specific CircleCI pipeline, including its status, configuration, trigger source, and commit details.
`circleci.circleci_list_workflows`	Read `read`	1	List all workflows for a specific CircleCI pipeline. Shows workflow names, statuses (running, success, failed, etc.), and timing information.
`circleci.circleci_get_workflow`	Read `read`	1	Get detailed information about a specific CircleCI workflow, including its status, timing, duration, and associated project.
`circleci.circleci_list_projects`	Read `read`	2	List all projects in a CircleCI organization. Returns project slugs, repository URLs, and VCS provider information.
`circleci.circleci_trigger_pipeline`	Write `write`	4	Trigger a new CI/CD pipeline on a CircleCI project. Specify the organization, project, branch, and optional pipeline parameters.
`circleci.circleci_get_current_user`	Read `read`	0	Get the current authenticated CircleCI user profile. Returns login, name, and account details. Useful for verifying API token validity.