Appcircle MCP

Appcircle MCP Server

MCP server for Appcircle: exposes Build, Signing Identities, Testing Distribution, Enterprise App Store, Publish to Stores, and Reporting tools to any MCP-capable client (Claude Desktop, Cursor, VS Code, etc.). The Appcircle MCP Server acts as the bridge between AI tools and Appcircle; thus, AI agents, assistants and chatbots to safely access and interact with Appcircle resources through structured, governed, and task-level tools.

Use Cases

• CI/CD and Workflow Intelligence: Monitor pipeline runs, track release status, and get insights into your mobile CI/CD workflows.
• Configuration and Environment Insights: Query build configurations and signing setup to understand how a project is configured and where issues may originate.
• Reporting and Operational Insights: Generate summaries of CI stability, recurring issues, pipeline performance, and overall CI/CD health.

Running Modes

You can use the MCP server in four ways:

Detailed client configuration (Cursor, Claude, etc.) lives in the dedicated installation guides; this section is a high-level summary only.

Installation

Client-specific setup guides:

• [Claude Applications](docs/installation_guides/claude_applications.md) - Installation guide for Claude Desktop and Claude Code CLI.
• [Cursor IDE](docs/installation_guides/cursor.md) - Installation guide for Cursor IDE.
• [Codex](docs/installation_guides/codex.md) - Installation guide for Codex app and Codex CLI.
• [Antigravity IDE](docs/installation_guides/antigravity.md) - Installation guide for Antigravity IDE.
• [VS Code (GitHub Copilot)](docs/installation_guides/vscode.md) - Installation guide for VS Code with GitHub Copilot.
• [Windsurf IDE](docs/installation_guides/windsurf.md) - Installation guide for Windsurf IDE.
• [Gemini CLI](docs/installation_guides/gemini_cli.md) - Installation guide for Gemini CLI.
• [GitHub Copilot CLI](docs/installation_guides/copilot_cli.md) - Installation guide for GitHub Copilot CLI.

Configuration (Environment Variables)

Set these in your shell or in your MCP client’s configuration.

Toolsets

Available Toolsets

The following sets of tools are available:

You can exclude one or more toolsets so their tools are not registered. Exclusions can be set via CLI arguments or the APPCIRCLE_EXCLUDED_TOOLSETS environment variable; both are merged (union).

• CLI: --exclude toolset1 toolset2 or --exclude-toolsets toolset1,toolset2
• Env: APPCIRCLE_EXCLUDED_TOOLSETS=build_module,report

Example MCP config (Cursor / Claude Desktop) with exclusions:

{

"mcpServers": { "appcircle": { "command": "appcircle-mcp", "args": ["--exclude", "report"] } } }

Tools

Tools are exposed via MCP tools/list. Reference below lists all tools by toolset; for response shape and examples see docs/tool_contract.md.

Build

• get_build_profiles - Get build profiles for the current organization (paginated). Optionally filter by profile name, platform, last build status, and repository source. Optionally sort.
• Access level: read
• page: Page number (1-based). Default: 1. (number, optional)
• size: Page size (1-100). Default: 25. Values above 100 are capped at 100. (number, optional)
• search: Optional search term to filter profiles (case-insensitive partial match on profile name; the API's search may also match other profile fields). (string, optional)
• platform: Optional list of platform codes to filter by. Allowed values: 1=iOS, 2=Android. (list of numbers, optional)
• last_build_status: Optional list of last build status codes to filter by. Allowed values: 0=Success, 1=Failed, 2=Canceled, 3=Timeout, 90=Waiting, 91=Running. (list of numbers, optional)
• repository_source: Optional list of repository source codes to filter by. Allowed values: 1=GitHub, 2=Bitbucket, 3=GitLab, 4=Azure DevOps, 6=Public Repository, 7=Private Repository, 8=SSH. (list of numbers, optional)
• sort: Optional sort field code. Allowed values: 1=Profile Name, 2=Create Date, 3=Last Build Date. (number, optional)
• sort_direction: Optional sort direction code. Allowed values: 1=ASC, 2=DESC. (number, optional)

• get_build_profile_details - Get a single build profile by ID, optionally including its build configurations.
• Access level: read
• profile_id: The build profile ID (e.g. UUID). (string, required)
• configurations: If true, also fetch the profile's build configurations. Default: false. (boolean, optional)

• get_build_configuration_details - Get a single build configuration by profile ID and configuration ID.
• Access level: read
• profile_id: The build profile ID (e.g. UUID). (string, required)
• configuration_id: The build configuration ID (e.g. UUID). (string, required)

• get_build_profile_workflows - Get workflows for a build profile by profile ID.
• Access level: read
• profile_id: The build profile ID (e.g. UUID). (string, required)

• get_workflow_detail - Get a single workflow by build profile ID and workflow ID.
• Access level: read
• profile_id: The build profile ID (e.g. UUID). (string, required)
• workflow_id: The workflow ID (e.g. UUID). (string, required)

• get_commits_by_branch - Get commits for a build branch (paginated).
• Access level: read
• branch_id: The branch ID (e.g. UUID). (string, required)
• page: Page number (1-based). If provided with size, enables pagination. Default: 1. (number, optional)
• size: Page size. If provided with page, enables pagination. Default: 25, max 100. (number, optional)

• get_commit_details - Get a single commit by commit ID (UUID) or by commit hash (git SHA). Provide either commit_id or commit_hash, not both.
• Access level: read
• commit_id: The commit ID (UUID). (string, optional)
• commit_hash: The commit hash (git SHA). (string, optional)

• get_last_commit - Get the most recent commit on a build branch.
• Access level: read
• branch_id: The branch ID (e.g. UUID). (string, required)

• get_build_status - Get the status of a build (e.g. 0=Success, 1=Failed, 2=Canceled, 3=Timeout, 90=Waiting, 91=Running, 92=Completing, 99=Unknown).
• Access level: read
• commit_id: The commit ID (UUID). (string, required)
• build_id: The build ID (UUID). (string, required)

• get_build_logs - Get the logs for a build, optionally scoped to a single step. Defaults to a tail-truncated view to avoid flooding the model's context.
• Access level: read
• commit_id: The commit ID (UUID). (string, required)
• build_id: The build ID (UUID). (string, required)
• step: Optional exact step name (case-insensitive) to scope output to one step's log block. (string, optional)
• full_log: If true, return the entire log instead of the default tail. Still capped at 256 KB. Default: false. (boolean, optional)
• tail_lines: Number of lines to keep from the end when not using full_log. Default: 200, max 1000. (number, optional)
• grep: Case-insensitive substring filter applied to lines before truncation. (string, optional)

• get_variable_groups - Get all build environment variable groups for the organization, including each group's variables (key, value, isSecret, isFile). Secret values are already redacted by the API.
• Access level: read
• Takes no parameters.

• trigger_build - SIDE EFFECT: starts a new real build run (queues an actual build, consuming build minutes/credits) either on a branch (latest synced commit) or for one specific commit. Registered by default; set AC_MCP_ENABLE_WRITE_TOOLS=false to opt out.
• Access level: write
• profile_id: The build profile ID (e.g. UUID). Required in branch mode (commit_id not given); unused in commit mode. (string, optional)
• workflow_id: The workflow ID (e.g. UUID). Required in branch mode. Optional in commit mode (uses the last-used/default workflow if omitted). (string, optional)
• branch_name: Optional branch name (e.g. "main"). Branch mode only; falls back to the profile's default branch if omitted. Must not be given together with commit_id. (string, optional)
• commit_id: The commit's own ID (not its git hash) to trigger a build for a specific commit instead of the latest one on a branch. Must not be given together with branch_name. (string, optional)
• configuration_id: Optional build configuration ID (e.g. UUID) to use instead of the default. (string, optional)

• cancel_build - SIDE EFFECT: cancels a queued or running build (real, in-progress work is stopped; cannot be resumed). Registered by default; set AC_MCP_ENABLE_WRITE_TOOLS=false to opt out.
• Access level: write
• task_id: The build's task ID (the "taskId" field returned by trigger_build). (string, required)

Signing Identities

• **get_bund