Is the Appcircle MCP MCP server free to use?

Yes. Appcircle MCP is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

Is the Appcircle MCP MCP server free to use?

Yes. Appcircle MCP is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

Appcircle MCP

MCP server for Appcircle mobile CI/CD platform.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "appcircle-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "appcircle-mcp"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Documentation Overview

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:

Mode	Summary
1. Remote host	Connect to https://mcp.appcircle.io. No local install; your client sends your Appcircle token (e.g. `Authorization: Bearer <token>`) on each request.
2. Local (stdio)	Run the server from source: clone the repo, optionally use a venv, then run `appcircle-mcp` (default transport is stdio). Requires Python and pip. Set `APPCIRCLE_ACCESS_TOKEN` in the environment. Your MCP client runs the server as a subprocess.
3. Local (streamable-http)	Run the server locally over HTTP: use `--transport streamable-http` and optionally `--host` / `--port` (e.g. `appcircle-mcp --transport streamable-http --host 127.0.0.1 --port 8000`). Clients connect to that URL and send their token in the request.
4. Local (Docker)	Run the official Docker image on your machine. Requires Docker. Use the image’s default port or override with `--port`; see the image documentation for exact usage.

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 - Installation guide for Claude Desktop and Claude Code CLI.
Cursor IDE - Installation guide for Cursor IDE.
Codex - Installation guide for Codex app and Codex CLI.
Antigravity IDE - Installation guide for Antigravity IDE.
VS Code (GitHub Copilot) - Installation guide for VS Code with GitHub Copilot.
Windsurf IDE - Installation guide for Windsurf IDE.
Gemini CLI - Installation guide for Gemini CLI.
GitHub Copilot CLI - Installation guide for GitHub Copilot CLI.

Configuration (Environment Variables)

Variable	Required	Description
`APPCIRCLE_ACCESS_TOKEN`	Yes (stdio only)	Appcircle API access token. Required when using stdio transport. For streamable-http, each client sends its own token. See Obtaining a token for how to get one.
`APPCIRCLE_API_URL`	No	API base URL (default: `https://api.appcircle.io` may differ for self-hosted users).
`APPCIRCLE_MCP_ALLOWED_HOST`	No (streamable-http only)	Public hostname for the MCP server (e.g. `mcp.appcircle.io`). Set this when deploying behind a reverse proxy so the server accepts the `Host` header from clients. Omit for localhost.
`APPCIRCLE_MCP_PORT`	No (streamable-http only)	Bind port for the HTTP server (default: `8000`). Overridden by `--port` if provided. Useful for on-prem or Docker when a specific port is required.
`LOG_LEVEL`	No	Logging level, e.g. `DEBUG`, `INFO` (default: `INFO`).
`APPCIRCLE_EXCLUDED_TOOLSETS`	No	Comma-separated toolsets to exclude (e.g. `build_module,report`). See Toolsets below.
`AC_MCP_ENABLE_WRITE_TOOLS`	No	Write/action tools (e.g. `trigger_build`, `cancel_build`) are registered by default. Set to `false`/`0`/`no`/`off` to opt out and not register them at all (not just disable at call time).

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

Toolsets

Available Toolsets

The following sets of tools are available:

Toolset	Description
`build_module`	Build profiles, configurations, workflows, commits, and pipeline operations
`signing_identities`	Signing identities and bundle identifiers
`testing_distribution`	Testing distribution profiles and distribution details
`publish_to_stores`	Publish profiles and store publishing operations
`enterprise_app_store`	Enterprise app store profiles and store details
`report`	Reporting: build history, distribution, signing, publish status, and related reports

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:

config.json

{
  "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_bundle_identifiers - Get all bundle identifiers for the organization (iOS/macOS app bundle IDs).
- Access level: read
- No parameters.
get_certificates - Get all signing certificates for the organization. Sensitive fields (p12Password, p12Binary, metaData, thumbprint) are omitted.
- Access level: read
- No parameters.
get_keystores - Get all keystores for the organization (e.g. Android signing keystores). Sensitive fields (password, aliasPassword, binary, checkSum, sha256FingerPrint) are omitted.
- Access level: read
- No parameters.
get_provisioning_profiles - Get provisioning profiles for the organization (e.g. iOS/macOS). Sensitive/large fields (binary, metaData, certificateThumbPrints, provisionedDevices, connectApiKeyId) are omitted. Optionally filter by app (bundle) ID.
- Access level: read
- app_id: Optional app (bundle) ID to filter provisioning profiles (e.g. com.example.app). (string, optional)

Testing Distribution

get_distribution_profiles - Get testing distribution profiles for the current organization (paginated). Optionally filter by profile name, platform, and authentication type. Optionally sort.
- Access level: read
- page: Page number (1-based). Default: 1. (number, optional)
- size: Page size (1-100). Default: 25, max 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)
- authentication_type: Optional list of authentication type codes to filter by. Allowed values: 1=None, 3=Static Login, 4=LDAP, 5=SSO. (list of numbers, optional)
- sort: Optional sort field code. Allowed values: 1=Profile Name, 2=Create Date, 3=Last Upload Date. (number, optional)
- sort_direction: Optional sort direction code. Allowed values: 1=ASC, 2=DESC. (number, optional)
get_distribution_profile_details - Get a single testing distribution profile by ID (with optional app versions pagination).
- Access level: read
- profile_id: The distribution profile ID (e.g. UUID). (string, required)
- page: Page number for app versions (1-based). Default: 1. (number, optional)
- size: Page size for app versions (1-100). Default: 25, max 100. (number, optional)
get_testing_groups - Get all testing distribution groups for the organization, including each group's member tester emails and group type.
- Access level: read
- Takes no parameters.
update_app_version_release_notes - SIDE EFFECT: overwrites the release notes ("message") shown to testers for a distribution app version. Returns the updated app version object (excludes certThumbPrints). Registered by default; set AC_MCP_ENABLE_WRITE_TOOLS=false to opt out.
- Access level: write
- profile_id: The distribution profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
- message: The new release notes text. (string, required)
send_app_version_to_testers - SIDE EFFECT: sends a real notification to testers/a testing group, dispatching a distribution task for a specific app version. Registered by default; set AC_MCP_ENABLE_WRITE_TOOLS=false to opt out.
- Access level: write
- profile_id: The distribution profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
- message: The notification message shown to testers. (string, required)
- testers: List of testers to send to. Each entry is either a tester's email address or a testing group ID (the "id" field from get_testing_groups). (list of strings, required)

Publish to Stores

get_publish_profiles - Get publish profiles for the current organization for a given platform type (paginated). Optionally filter by flow status, target marketplace, release-candidate binary presence, and store status. Optionally sort.
- Access level: read
- platform_type: Platform type of publish profiles ("ios" or "android"). (string, required)
- page: Page number (1-based). Default: 1. (number, optional)
- size: Page size (1-100). Default: 25, max 100. (number, optional)
- flow_status: Optional flow status code to filter by (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)
- market_place_type: Optional list of target marketplace codes to filter by. Allowed values depend on platform_type -- ios: 0=Not Available, 1=App Store Connect, 4=Intune; android: 0=Not Available, 2=Google Play, 3=AppGallery, 4=Intune. (list of numbers, optional)
- has_rc_binary: Optional filter for whether the profile has a release-candidate binary. (boolean, optional)
- store_status: Optional list of store status codes to filter by. Allowed values depend on platform_type (many more codes for ios than android, e.g. ios: "IN_REVIEW", "READY_FOR_SALE", "REJECTED"; android: "NOT_AVAILABLE", "DRAFT", "IN_PROGRESS", "HALTED", "COMPLETED"). (list of strings, optional)
- sort: Optional sort field code. Allowed values: 1=Profile Name, 2=Create Date. (number, optional)
- sort_direction: Optional sort direction code. Allowed values: 1=ASC, 2=DESC. (number, optional)
get_publish_profile_details - Get a single publish profile by platform type and ID (with optional app versions pagination).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- page: Page number for app versions (1-based). Default: 1. (number, optional)
- size: Page size for app versions (1-100). Default: 25, max 100. (number, optional)
get_app_version_metadata - Get store listing metadata for a single app version (app review information, localizations, release information, app version information). appReviewInformation.demoPassword is excluded.
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
get_metadata_locales - Get the available store metadata locales for a single app version (name, code, localized, isPrimary).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
get_intune_metadata - Get Microsoft Intune app metadata for a single app version (display name, publisher, bundle ID, version, publishing state, applicable device types, categories, etc.).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
get_publish_metadata_lock_status - Get whether a publish profile's store metadata is locked for editing.
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
get_publish_details - Get the publish flow run details for a single app version (status, timing, ordered steps with run history/artifacts/log resource IDs).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
get_publish_step_logs - Get the logs for a publish flow run, optionally scoped to a single step. Defaults to a tail-truncated view to avoid flooding the model's context.
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- publish_id: The publish flow run ID (the "id" field from get_publish_details). (string, required)
- step_id: The step ID (a step's "id" field from get_publish_details' steps list). (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_publish_flows - Get the publish flows configured for a publish profile (name, ID, full flow document YAML).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
start_publish - SIDE EFFECT: starts a publish flow run (or restarts it from a specific step) -- real publishing work (e.g. uploading to the App Store/Play Store/Intune). Registered by default; set AC_MCP_ENABLE_WRITE_TOOLS=false to opt out.
- Access level: write
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- publish_id: The publish flow run ID (the "id" field from get_publish_details). (string, required)
- step_id: Optional step ID to start from that step instead of the beginning of the flow. (string, optional)
- organization_pool_id: Optional organization pool ID (e.g. UUID) to run on. (string, optional)
stop_publish - SIDE EFFECT: cancels a running publish flow run (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
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- publish_id: The publish flow run ID (the "id" field from get_publish_details). (string, required)
- step_id: Optional step ID. (string, optional)
- organization_pool_id: Optional organization pool ID (e.g. UUID). (string, optional)

Enterprise App Store

get_store_profiles - Get enterprise app store profiles for the current organization (paginated). Does not support search, but can filter by platform, publish type, and visibility. Optionally sort.
- Access level: read
- page: Page number (1-based). Default: 1. (number, optional)
- size: Page size (1-100). Default: 25, max 100. (number, optional)
- platform_type: Optional list of platform codes to filter by. Allowed values: 1=iOS, 2=Android. (list of numbers, optional)
- publish_type: Optional list of publish type codes to filter by. Allowed values: 1=Published to Beta, 2=Published to Live. (list of numbers, optional)
- visibility: Optional filter for whether the profile is publicly listed (true=Listed, false=Unlisted). (boolean, optional)
- sort: Optional sort field code. Allowed values: 1=App Name, 2=Create Date, 3=Download Count, 4=Binary Receive Date. (number, optional)
- sort_direction: Optional sort direction code. Allowed values: 1=ASC, 2=DESC. (number, optional)
get_store_profile_details - Get a single enterprise app store profile by ID (with optional app versions pagination).
- Access level: read
- profile_id: The enterprise app store profile ID (e.g. UUID). (string, required)
- page: Page number for app versions (1-based). Default: 1. (number, optional)
- size: Page size for app versions (1-100). Default: 25, max 100. (number, optional)
- Each app version's publishType field is an int: 0=None, 1=Beta, 2=Live.

Report

get_build_history_report - Get build history report, optionally filtered by date range, build profile, and organization. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- build_profile_name: Filter by build profile name. (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
get_build_queue_waiting_report - Get the build queue waiting report, optionally filtered by date range. Paginated. Note: on this endpoint, buildDuration means queue wait time in minutes, not execution time (unlike get_build_history_report).
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). Must be <= end_date if both are given. (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
get_build_activity_log - Get the build activity log (workflow/profile changes, CodePush releases, etc.), optionally filtered by date range and other parameters. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). Must be <= end_date if both are given. (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Filter by organization UUID. (string, optional)
- platform: Filter by platform type (integer code, e.g. 0=Android, 1=iOS). (number, optional)
- email: Filter by acting user's email. (string, optional)
- profile_name: Filter by build profile name. (string, optional)
- action: Filter by activity action code (integer; see BUILD_ACTIVITY_ACTIONS in the tool source for the full mapping). (number, optional)
get_build_insights_report - Get a computed Build Insights Report (Health Snapshot + Trends, Root Cause, Artifact Health, Workflow Quality, Queue Time, and Maturity Assessment analysis) over build history, aggregated server-side. Unlike get_build_history_report, this fetches every page internally and returns small pre-aggregated results instead of raw records.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD) for the current period. Default: last 30 days. (string, optional)
- end_date: Optional end date (YYYY-MM-DD) for the current period. (string, optional)
- sections: Optional list of sections to compute: health_snapshot, root_cause, artifact_health, workflow_quality, queue_time, maturity_assessment. Default: all six. (array of strings, optional)
- include_sub_orgs: If true, keep cross-org build records in history-derived metrics instead of filtering to the token's own organization. Default: false. (boolean, optional)
get_distribution_app_version_report - Get daily usage report for distributed app versions. Paginated; supports filters by profile, OS, organization.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- profile_name: Filter by distribution profile name. (string, optional)
- os: Filter by OS ("ios" or "android"). (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
get_distribution_sent_report - Get daily usage report for distributed app sharing. Paginated; supports filters by profile, OS, organization.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- profile_name: Filter by distribution profile name. (string, optional)
- os: Filter by OS ("ios" or "android"). (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
get_enterprise_app_store_app_usage_report - Get app usage report for enterprise app store. start_date and end_date are required. Paginated.
- Access level: read
- start_date: Start date (YYYY-MM-DD). (string, required)
- end_date: End date (YYYY-MM-DD). (string, required)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Optional filter by organization UUID. (string, optional)
get_publish_resign_report - Get publish resign report, optionally filtered by date range, app name, organization, and status. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- app_name: Filter by app name. (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
- status: Filter by resign status (0=waiting, 1=processing, 2=succeeded, 3=failed, 4=cancelled, 5=timeout). (number, optional)
get_publish_status_report - Get publish status report, optionally filtered by date range, app name, organization, and status. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- app_name: Filter by app name. (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
- status: Filter by publish status (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)
get_signing_report - Get signing report, optionally filtered by date range, organization, OS, and build status. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Filter by organization UUID. (string, optional)
- os: Filter by OS ("ios" or "android"). (string, optional)
- build_status: Filter by build status (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)
get_signing_activity_log - Get the signing activity log (e.g. certificate/provisioning profile/keystore expiry notices), optionally filtered by date range and other parameters. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). Must be <= end_date if both are given. (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Filter by organization UUID. (string, optional)
- platform: Filter by platform (e.g. "iOS", "Android"). (string, optional)
- email: Filter by acting user's email. (string, optional)
- action: Filter by activity action code (integer; see SIGNING_ACTIVITY_ACTIONS in the tool source for the full mapping). (number, optional)
get_publish_activity_log - Get the publish activity log (re-sign, publish flow events, etc.), optionally filtered by date range and other parameters. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). Must be <= end_date if both are given. (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Filter by organization UUID. (string, optional)
- platform: Filter by platform (e.g. "iOS", "Android"). (string, optional)
- email: Filter by acting user's email. (string, optional)
- profile_name: Filter by publish profile name. (string, optional)
- action: Filter by activity action code (integer; see PUBLISH_ACTIVITY_ACTIONS in the tool source for the full mapping). (number, optional)

Running the server

From the repo root:

bash

python -m src.server

Or after pip install -e .:

bash

appcircle-mcp

The server runs over stdio (or SSE/HTTP depending on how your client starts it).

Response format

Every tool returns a standard envelope:

Success: { "success": true, "data": <payload>, "meta": { ... } }
data is the tool result; meta is optional (e.g. count, page, filters).
Error: { "success": false, "error": { "tool", "type", "message", "details" } }
Same shape for all tools so clients can parse errors consistently.

Full specification: docs/tool_contract.md.

Testing

Install with dev dependencies:

Terminal

pip install -e ".[dev]"

Unit tests (default)

Use a mocked API; no APPCIRCLE_ACCESS_TOKEN needed. Default pytest only runs these (see testpaths in pyproject.toml):

bash

pytest test/unit/ -v

Single file: pytest test/unit/tools/build_module/test_get_build_profiles.py -v
With coverage: pytest test/unit/ --cov=src --cov-report=term-missing

Integration tests

Call the real Appcircle API. Set APPCIRCLE_ACCESS_TOKEN in the environment, then run:

bash

pytest test/integration/ -v

All integration tests: pytest test/integration/ -v
By tool: pytest test/integration/build_module/ -v, pytest test/integration/report/ -v, etc.
By marker: pytest -m integration -v (when running from repo root; includes only integration tests if both unit and integration are collected)

If APPCIRCLE_ACCESS_TOKEN is not set, integration tests are skipped (no failure).

Optional env vars for integration tests (when discovery fails or tests need real IDs; omit to skip those tests):

Variable	Description
`APPCIRCLE_TEST_ORGANIZATION_ID`	Organization UUID. Used by `test_with_organization_id` (enterprise app store app usage report).
`APPCIRCLE_TEST_BRANCH_ID`	Branch UUID. Used by get_commits_by_branch and related tests when no branch can be discovered from the API.
`APPCIRCLE_TEST_COMMIT_ID`	Commit UUID. Used by get_commit_details tests when no commit can be discovered from the API.

Write/action integration tests (trigger_build, cancel_build, etc.) are marked integration_write and are opt-in on top of APPCIRCLE_ACCESS_TOKEN — they mutate real data (trigger real builds, etc.), so they never run just from pytest test/integration/ -v. Set APPCIRCLE_RUN_WRITE_INTEGRATION_TESTS=true (pointing APPCIRCLE_ACCESS_TOKEN at a dedicated test org, not production) to enable them.

Security

This project depends on third-party open-source packages listed in pyproject.toml. While we pin dependency version ranges and ship a lockfile (uv.lock) with cryptographic hashes, these packages are maintained independently and provided "as-is." Appcircle makes no guarantees regarding the security or reliability of third-party dependencies.

We recommend auditing installed packages before use:

bash

uv run pip-audit

Related MCP Servers

View all in Developer Tools View all alternatives

Frequently Asked Questions about Appcircle MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "appcircle-mcp": { "command": "npx", "args": ["-y", "Appcircle MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/appcircle-mcp?style=directory)](https://allmcps.com/mcp/appcircle-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/appcircle-mcp"><img src="https://allmcps.com/api/badge/appcircle-mcp?style=directory" alt="Appcircle MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

0/5 checks healthy over the last 6h

25Quality signal: Emerging · 25/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools10/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 3,181+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Appcircle MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Appcircle MCP

MCP server for Appcircle mobile CI/CD platform.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "appcircle-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "appcircle-mcp"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Documentation Overview

Appcircle MCP Server

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:

Mode	Summary
1. Remote host	Connect to https://mcp.appcircle.io. No local install; your client sends your Appcircle token (e.g. `Authorization: Bearer <token>`) on each request.
2. Local (stdio)	Run the server from source: clone the repo, optionally use a venv, then run `appcircle-mcp` (default transport is stdio). Requires Python and pip. Set `APPCIRCLE_ACCESS_TOKEN` in the environment. Your MCP client runs the server as a subprocess.
3. Local (streamable-http)	Run the server locally over HTTP: use `--transport streamable-http` and optionally `--host` / `--port` (e.g. `appcircle-mcp --transport streamable-http --host 127.0.0.1 --port 8000`). Clients connect to that URL and send their token in the request.
4. Local (Docker)	Run the official Docker image on your machine. Requires Docker. Use the image’s default port or override with `--port`; see the image documentation for exact usage.

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 - Installation guide for Claude Desktop and Claude Code CLI.
Cursor IDE - Installation guide for Cursor IDE.
Codex - Installation guide for Codex app and Codex CLI.
Antigravity IDE - Installation guide for Antigravity IDE.
VS Code (GitHub Copilot) - Installation guide for VS Code with GitHub Copilot.
Windsurf IDE - Installation guide for Windsurf IDE.
Gemini CLI - Installation guide for Gemini CLI.
GitHub Copilot CLI - Installation guide for GitHub Copilot CLI.

Configuration (Environment Variables)

Variable	Required	Description
`APPCIRCLE_ACCESS_TOKEN`	Yes (stdio only)	Appcircle API access token. Required when using stdio transport. For streamable-http, each client sends its own token. See Obtaining a token for how to get one.
`APPCIRCLE_API_URL`	No	API base URL (default: `https://api.appcircle.io` may differ for self-hosted users).
`APPCIRCLE_MCP_ALLOWED_HOST`	No (streamable-http only)	Public hostname for the MCP server (e.g. `mcp.appcircle.io`). Set this when deploying behind a reverse proxy so the server accepts the `Host` header from clients. Omit for localhost.
`APPCIRCLE_MCP_PORT`	No (streamable-http only)	Bind port for the HTTP server (default: `8000`). Overridden by `--port` if provided. Useful for on-prem or Docker when a specific port is required.
`LOG_LEVEL`	No	Logging level, e.g. `DEBUG`, `INFO` (default: `INFO`).
`APPCIRCLE_EXCLUDED_TOOLSETS`	No	Comma-separated toolsets to exclude (e.g. `build_module,report`). See Toolsets below.
`AC_MCP_ENABLE_WRITE_TOOLS`	No	Write/action tools (e.g. `trigger_build`, `cancel_build`) are registered by default. Set to `false`/`0`/`no`/`off` to opt out and not register them at all (not just disable at call time).

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

Toolsets

Available Toolsets

The following sets of tools are available:

Toolset	Description
`build_module`	Build profiles, configurations, workflows, commits, and pipeline operations
`signing_identities`	Signing identities and bundle identifiers
`testing_distribution`	Testing distribution profiles and distribution details
`publish_to_stores`	Publish profiles and store publishing operations
`enterprise_app_store`	Enterprise app store profiles and store details
`report`	Reporting: build history, distribution, signing, publish status, and related reports

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:

config.json

{
  "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_bundle_identifiers - Get all bundle identifiers for the organization (iOS/macOS app bundle IDs).
- Access level: read
- No parameters.
get_certificates - Get all signing certificates for the organization. Sensitive fields (p12Password, p12Binary, metaData, thumbprint) are omitted.
- Access level: read
- No parameters.
get_keystores - Get all keystores for the organization (e.g. Android signing keystores). Sensitive fields (password, aliasPassword, binary, checkSum, sha256FingerPrint) are omitted.
- Access level: read
- No parameters.
get_provisioning_profiles - Get provisioning profiles for the organization (e.g. iOS/macOS). Sensitive/large fields (binary, metaData, certificateThumbPrints, provisionedDevices, connectApiKeyId) are omitted. Optionally filter by app (bundle) ID.
- Access level: read
- app_id: Optional app (bundle) ID to filter provisioning profiles (e.g. com.example.app). (string, optional)

Testing Distribution

get_distribution_profiles - Get testing distribution profiles for the current organization (paginated). Optionally filter by profile name, platform, and authentication type. Optionally sort.
- Access level: read
- page: Page number (1-based). Default: 1. (number, optional)
- size: Page size (1-100). Default: 25, max 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)
- authentication_type: Optional list of authentication type codes to filter by. Allowed values: 1=None, 3=Static Login, 4=LDAP, 5=SSO. (list of numbers, optional)
- sort: Optional sort field code. Allowed values: 1=Profile Name, 2=Create Date, 3=Last Upload Date. (number, optional)
- sort_direction: Optional sort direction code. Allowed values: 1=ASC, 2=DESC. (number, optional)
get_distribution_profile_details - Get a single testing distribution profile by ID (with optional app versions pagination).
- Access level: read
- profile_id: The distribution profile ID (e.g. UUID). (string, required)
- page: Page number for app versions (1-based). Default: 1. (number, optional)
- size: Page size for app versions (1-100). Default: 25, max 100. (number, optional)
get_testing_groups - Get all testing distribution groups for the organization, including each group's member tester emails and group type.
- Access level: read
- Takes no parameters.
update_app_version_release_notes - SIDE EFFECT: overwrites the release notes ("message") shown to testers for a distribution app version. Returns the updated app version object (excludes certThumbPrints). Registered by default; set AC_MCP_ENABLE_WRITE_TOOLS=false to opt out.
- Access level: write
- profile_id: The distribution profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
- message: The new release notes text. (string, required)
send_app_version_to_testers - SIDE EFFECT: sends a real notification to testers/a testing group, dispatching a distribution task for a specific app version. Registered by default; set AC_MCP_ENABLE_WRITE_TOOLS=false to opt out.
- Access level: write
- profile_id: The distribution profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
- message: The notification message shown to testers. (string, required)
- testers: List of testers to send to. Each entry is either a tester's email address or a testing group ID (the "id" field from get_testing_groups). (list of strings, required)

Publish to Stores

get_publish_profiles - Get publish profiles for the current organization for a given platform type (paginated). Optionally filter by flow status, target marketplace, release-candidate binary presence, and store status. Optionally sort.
- Access level: read
- platform_type: Platform type of publish profiles ("ios" or "android"). (string, required)
- page: Page number (1-based). Default: 1. (number, optional)
- size: Page size (1-100). Default: 25, max 100. (number, optional)
- flow_status: Optional flow status code to filter by (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)
- market_place_type: Optional list of target marketplace codes to filter by. Allowed values depend on platform_type -- ios: 0=Not Available, 1=App Store Connect, 4=Intune; android: 0=Not Available, 2=Google Play, 3=AppGallery, 4=Intune. (list of numbers, optional)
- has_rc_binary: Optional filter for whether the profile has a release-candidate binary. (boolean, optional)
- store_status: Optional list of store status codes to filter by. Allowed values depend on platform_type (many more codes for ios than android, e.g. ios: "IN_REVIEW", "READY_FOR_SALE", "REJECTED"; android: "NOT_AVAILABLE", "DRAFT", "IN_PROGRESS", "HALTED", "COMPLETED"). (list of strings, optional)
- sort: Optional sort field code. Allowed values: 1=Profile Name, 2=Create Date. (number, optional)
- sort_direction: Optional sort direction code. Allowed values: 1=ASC, 2=DESC. (number, optional)
get_publish_profile_details - Get a single publish profile by platform type and ID (with optional app versions pagination).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- page: Page number for app versions (1-based). Default: 1. (number, optional)
- size: Page size for app versions (1-100). Default: 25, max 100. (number, optional)
get_app_version_metadata - Get store listing metadata for a single app version (app review information, localizations, release information, app version information). appReviewInformation.demoPassword is excluded.
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
get_metadata_locales - Get the available store metadata locales for a single app version (name, code, localized, isPrimary).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
get_intune_metadata - Get Microsoft Intune app metadata for a single app version (display name, publisher, bundle ID, version, publishing state, applicable device types, categories, etc.).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
get_publish_metadata_lock_status - Get whether a publish profile's store metadata is locked for editing.
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
get_publish_details - Get the publish flow run details for a single app version (status, timing, ordered steps with run history/artifacts/log resource IDs).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- app_version_id: The app version ID (e.g. UUID). (string, required)
get_publish_step_logs - Get the logs for a publish flow run, optionally scoped to a single step. Defaults to a tail-truncated view to avoid flooding the model's context.
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- publish_id: The publish flow run ID (the "id" field from get_publish_details). (string, required)
- step_id: The step ID (a step's "id" field from get_publish_details' steps list). (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_publish_flows - Get the publish flows configured for a publish profile (name, ID, full flow document YAML).
- Access level: read
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
start_publish - SIDE EFFECT: starts a publish flow run (or restarts it from a specific step) -- real publishing work (e.g. uploading to the App Store/Play Store/Intune). Registered by default; set AC_MCP_ENABLE_WRITE_TOOLS=false to opt out.
- Access level: write
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- publish_id: The publish flow run ID (the "id" field from get_publish_details). (string, required)
- step_id: Optional step ID to start from that step instead of the beginning of the flow. (string, optional)
- organization_pool_id: Optional organization pool ID (e.g. UUID) to run on. (string, optional)
stop_publish - SIDE EFFECT: cancels a running publish flow run (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
- platform_type: Platform type ("ios" or "android"). (string, required)
- profile_id: The publish profile ID (e.g. UUID). (string, required)
- publish_id: The publish flow run ID (the "id" field from get_publish_details). (string, required)
- step_id: Optional step ID. (string, optional)
- organization_pool_id: Optional organization pool ID (e.g. UUID). (string, optional)

Enterprise App Store

get_store_profiles - Get enterprise app store profiles for the current organization (paginated). Does not support search, but can filter by platform, publish type, and visibility. Optionally sort.
- Access level: read
- page: Page number (1-based). Default: 1. (number, optional)
- size: Page size (1-100). Default: 25, max 100. (number, optional)
- platform_type: Optional list of platform codes to filter by. Allowed values: 1=iOS, 2=Android. (list of numbers, optional)
- publish_type: Optional list of publish type codes to filter by. Allowed values: 1=Published to Beta, 2=Published to Live. (list of numbers, optional)
- visibility: Optional filter for whether the profile is publicly listed (true=Listed, false=Unlisted). (boolean, optional)
- sort: Optional sort field code. Allowed values: 1=App Name, 2=Create Date, 3=Download Count, 4=Binary Receive Date. (number, optional)
- sort_direction: Optional sort direction code. Allowed values: 1=ASC, 2=DESC. (number, optional)
get_store_profile_details - Get a single enterprise app store profile by ID (with optional app versions pagination).
- Access level: read
- profile_id: The enterprise app store profile ID (e.g. UUID). (string, required)
- page: Page number for app versions (1-based). Default: 1. (number, optional)
- size: Page size for app versions (1-100). Default: 25, max 100. (number, optional)
- Each app version's publishType field is an int: 0=None, 1=Beta, 2=Live.

Report

get_build_history_report - Get build history report, optionally filtered by date range, build profile, and organization. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- build_profile_name: Filter by build profile name. (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
get_build_queue_waiting_report - Get the build queue waiting report, optionally filtered by date range. Paginated. Note: on this endpoint, buildDuration means queue wait time in minutes, not execution time (unlike get_build_history_report).
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). Must be <= end_date if both are given. (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
get_build_activity_log - Get the build activity log (workflow/profile changes, CodePush releases, etc.), optionally filtered by date range and other parameters. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). Must be <= end_date if both are given. (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Filter by organization UUID. (string, optional)
- platform: Filter by platform type (integer code, e.g. 0=Android, 1=iOS). (number, optional)
- email: Filter by acting user's email. (string, optional)
- profile_name: Filter by build profile name. (string, optional)
- action: Filter by activity action code (integer; see BUILD_ACTIVITY_ACTIONS in the tool source for the full mapping). (number, optional)
get_build_insights_report - Get a computed Build Insights Report (Health Snapshot + Trends, Root Cause, Artifact Health, Workflow Quality, Queue Time, and Maturity Assessment analysis) over build history, aggregated server-side. Unlike get_build_history_report, this fetches every page internally and returns small pre-aggregated results instead of raw records.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD) for the current period. Default: last 30 days. (string, optional)
- end_date: Optional end date (YYYY-MM-DD) for the current period. (string, optional)
- sections: Optional list of sections to compute: health_snapshot, root_cause, artifact_health, workflow_quality, queue_time, maturity_assessment. Default: all six. (array of strings, optional)
- include_sub_orgs: If true, keep cross-org build records in history-derived metrics instead of filtering to the token's own organization. Default: false. (boolean, optional)
get_distribution_app_version_report - Get daily usage report for distributed app versions. Paginated; supports filters by profile, OS, organization.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- profile_name: Filter by distribution profile name. (string, optional)
- os: Filter by OS ("ios" or "android"). (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
get_distribution_sent_report - Get daily usage report for distributed app sharing. Paginated; supports filters by profile, OS, organization.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- profile_name: Filter by distribution profile name. (string, optional)
- os: Filter by OS ("ios" or "android"). (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
get_enterprise_app_store_app_usage_report - Get app usage report for enterprise app store. start_date and end_date are required. Paginated.
- Access level: read
- start_date: Start date (YYYY-MM-DD). (string, required)
- end_date: End date (YYYY-MM-DD). (string, required)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Optional filter by organization UUID. (string, optional)
get_publish_resign_report - Get publish resign report, optionally filtered by date range, app name, organization, and status. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- app_name: Filter by app name. (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
- status: Filter by resign status (0=waiting, 1=processing, 2=succeeded, 3=failed, 4=cancelled, 5=timeout). (number, optional)
get_publish_status_report - Get publish status report, optionally filtered by date range, app name, organization, and status. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- app_name: Filter by app name. (string, optional)
- organization_id: Filter by organization UUID. (string, optional)
- status: Filter by publish status (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)
get_signing_report - Get signing report, optionally filtered by date range, organization, OS, and build status. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Filter by organization UUID. (string, optional)
- os: Filter by OS ("ios" or "android"). (string, optional)
- build_status: Filter by build status (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)
get_signing_activity_log - Get the signing activity log (e.g. certificate/provisioning profile/keystore expiry notices), optionally filtered by date range and other parameters. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). Must be <= end_date if both are given. (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Filter by organization UUID. (string, optional)
- platform: Filter by platform (e.g. "iOS", "Android"). (string, optional)
- email: Filter by acting user's email. (string, optional)
- action: Filter by activity action code (integer; see SIGNING_ACTIVITY_ACTIONS in the tool source for the full mapping). (number, optional)
get_publish_activity_log - Get the publish activity log (re-sign, publish flow events, etc.), optionally filtered by date range and other parameters. Paginated.
- Access level: read
- start_date: Optional start date (YYYY-MM-DD). Must be <= end_date if both are given. (string, optional)
- end_date: Optional end date (YYYY-MM-DD). (string, optional)
- page: Page number (default: 1). (number, optional)
- size: Items per page (1-100, default: 50). (number, optional)
- organization_id: Filter by organization UUID. (string, optional)
- platform: Filter by platform (e.g. "iOS", "Android"). (string, optional)
- email: Filter by acting user's email. (string, optional)
- profile_name: Filter by publish profile name. (string, optional)
- action: Filter by activity action code (integer; see PUBLISH_ACTIVITY_ACTIONS in the tool source for the full mapping). (number, optional)

Running the server

From the repo root:

bash

python -m src.server

Or after pip install -e .:

bash

appcircle-mcp

The server runs over stdio (or SSE/HTTP depending on how your client starts it).

Response format

Every tool returns a standard envelope:

Success: { "success": true, "data": <payload>, "meta": { ... } }
data is the tool result; meta is optional (e.g. count, page, filters).
Error: { "success": false, "error": { "tool", "type", "message", "details" } }
Same shape for all tools so clients can parse errors consistently.

Full specification: docs/tool_contract.md.

Testing

Install with dev dependencies:

Terminal

pip install -e ".[dev]"

Unit tests (default)

Use a mocked API; no APPCIRCLE_ACCESS_TOKEN needed. Default pytest only runs these (see testpaths in pyproject.toml):

bash

pytest test/unit/ -v

Single file: pytest test/unit/tools/build_module/test_get_build_profiles.py -v
With coverage: pytest test/unit/ --cov=src --cov-report=term-missing

Integration tests

Call the real Appcircle API. Set APPCIRCLE_ACCESS_TOKEN in the environment, then run:

bash

pytest test/integration/ -v

All integration tests: pytest test/integration/ -v
By tool: pytest test/integration/build_module/ -v, pytest test/integration/report/ -v, etc.
By marker: pytest -m integration -v (when running from repo root; includes only integration tests if both unit and integration are collected)

If APPCIRCLE_ACCESS_TOKEN is not set, integration tests are skipped (no failure).

Optional env vars for integration tests (when discovery fails or tests need real IDs; omit to skip those tests):

Variable	Description
`APPCIRCLE_TEST_ORGANIZATION_ID`	Organization UUID. Used by `test_with_organization_id` (enterprise app store app usage report).
`APPCIRCLE_TEST_BRANCH_ID`	Branch UUID. Used by get_commits_by_branch and related tests when no branch can be discovered from the API.
`APPCIRCLE_TEST_COMMIT_ID`	Commit UUID. Used by get_commit_details tests when no commit can be discovered from the API.

Security

We recommend auditing installed packages before use:

bash

uv run pip-audit

Related MCP Servers

View all in Developer Tools View all alternatives

Frequently Asked Questions about Appcircle MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "appcircle-mcp": { "command": "npx", "args": ["-y", "Appcircle MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/appcircle-mcp?style=directory)](https://allmcps.com/mcp/appcircle-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/appcircle-mcp"><img src="https://allmcps.com/api/badge/appcircle-mcp?style=directory" alt="Appcircle MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

0/5 checks healthy over the last 6h

25Quality signal: Emerging · 25/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools10/30

Adoption & activity1/15

Community engagement0/10

★ Featured

AllMCPs Server

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Appcircle MCP →Install in Claude Desktop Install in Cursor Install in VS Code