Appcircle MCP Server

MCP server for [Appcircle](https://appcircle.io): exposes Build, Signing Identities, Testing Distribution, Enterprise App Store, Publish to Stores

Remote serverstreamable-httpPython

What is the Appcircle MCP Server?

MCP server for Appcircle: exposes Build, Signing Identities, Testing Distribution, Enterprise App Store, Publish to Stores, and Reporting

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_build_profilesGet build profiles for the current organization (paginated). Optionally filter by profile name, platform, last build status, and repository source. Optionally s
pagePage number (default: 1). (number, optional)
sizeItems per page (1-100, default: 50). (number, optional)
searchOptional search term to filter profiles (case-insensitive partial match on profile name; the API's search may also match other profile fields). (string, optiona
platformFilter by platform (e.g. "iOS", "Android"). (string, optional)
last_build_statusOptional 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, opt
repository_sourceOptional list of repository source codes to filter by. Allowed values: 1=GitHub, 2=Bitbucket, 3=GitLab, 4=Azure DevOps, 6=Public Repository, 7=Private Repositor
sortOptional sort field code. Allowed values: 1=App Name, 2=Create Date, 3=Download Count, 4=Binary Receive Date. (number, optional)
sort_directionOptional sort direction code. Allowed values: 1=ASC, 2=DESC. (number, optional)
get_build_profile_detailsGet a single build profile by ID, optionally including its build configurations.
profile_idThe enterprise app store profile ID (e.g. UUID). (string, required)
configurationsIf true, also fetch the profile's build configurations. Default: false. (boolean, optional)
get_build_configuration_detailsGet a single build configuration by profile ID and configuration ID.
configuration_idOptional build configuration ID (e.g. UUID) to use instead of the default. (string, optional)
get_build_profile_workflowsGet workflows for a build profile by profile ID.
get_workflow_detailGet a single workflow by build profile ID and workflow ID.
workflow_idThe workflow ID (e.g. UUID). Required in branch mode. Optional in commit mode (uses the last-used/default workflow if omitted). (string, optional)
get_commits_by_branchGet commits for a build branch (paginated).
branch_idThe branch ID (e.g. UUID). (string, required)
get_commit_detailsGet a single commit by commit ID (UUID) or by commit hash (git SHA). Provide either commit_id or commit_hash, not both.
commit_idThe 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_na
commit_hashThe commit hash (git SHA). (string, optional)
get_last_commitGet the most recent commit on a build branch.
get_build_statusGet the status of a build (e.g. 0=Success, 1=Failed, 2=Canceled, 3=Timeout, 90=Waiting, 91=Running, 92=Completing, 99=Unknown).
build_idThe build ID (UUID). (string, required)
get_build_logsGet the logs for a build, optionally scoped to a single step. Defaults to a tail-truncated view to avoid flooding the model's context.
stepOptional exact step name (case-insensitive) to scope output to one step's log block. (string, optional)
full_logIf true, return the entire log instead of the default tail. Still capped at 256 KB. Default: false. (boolean, optional)
tail_linesNumber of lines to keep from the end when not using full_log. Default: 200, max 1000. (number, optional)
grepCase-insensitive substring filter applied to lines before truncation. (string, optional)
get_variable_groupsGet all build environment variable groups for the organization, including each group's variables (key, value, isSecret, isFile). Secret values are already redac
trigger_buildSIDE 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
branch_nameOptional 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,
cancel_buildSIDE 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=fals
task_idThe build's task ID (the "taskId" field returned by trigger_build). (string, required)
get_bundle_identifiersGet all bundle identifiers for the organization (iOS/macOS app bundle IDs).
get_certificatesGet all signing certificates for the organization. Sensitive fields (p12Password, p12Binary, metaData, thumbprint) are omitted.
get_keystoresGet all keystores for the organization (e.g. Android signing keystores). Sensitive fields (password, aliasPassword, binary, checkSum, sha256FingerPrint) are omi
get_provisioning_profilesGet provisioning profiles for the organization (e.g. iOS/macOS). Sensitive/large fields (binary, metaData, certificateThumbPrints, provisionedDevices, connectAp
app_idOptional app (bundle) ID to filter provisioning profiles (e.g. com.example.app). (string, optional)
get_distribution_profilesGet testing distribution profiles for the current organization (paginated). Optionally filter by profile name, platform, and authentication type. Optionally sor
authentication_typeOptional list of authentication type codes to filter by. Allowed values: 1=None, 3=Static Login, 4=LDAP, 5=SSO. (list of numbers, optional)
get_distribution_profile_detailsGet a single testing distribution profile by ID (with optional app versions pagination).
get_testing_groupsGet all testing distribution groups for the organization, including each group's member tester emails and group type.
update_app_version_release_notesSIDE EFFECT: overwrites the release notes ("message") shown to testers for a distribution app version. Returns the updated app version object (excludes certThum
app_version_idThe app version ID (e.g. UUID). (string, required)
messageThe notification message shown to testers. (string, required)
send_app_version_to_testersSIDE 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
testersList 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, requ
get_publish_profilesGet publish profiles for the current organization for a given platform type (paginated). Optionally filter by flow status, target marketplace, release-candidate
platform_typeOptional list of platform codes to filter by. Allowed values: 1=iOS, 2=Android. (list of numbers, optional)
flow_statusOptional flow status code to filter by (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)
market_place_typeOptional 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:
has_rc_binaryOptional filter for whether the profile has a release-candidate binary. (boolean, optional)
store_statusOptional 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_FO
get_publish_profile_detailsGet a single publish profile by platform type and ID (with optional app versions pagination).
get_app_version_metadataGet store listing metadata for a single app version (app review information, localizations, release information, app version information). appReviewInformation.
get_metadata_localesGet the available store metadata locales for a single app version (name, code, localized, isPrimary).
get_intune_metadataGet Microsoft Intune app metadata for a single app version (display name, publisher, bundle ID, version, publishing state, applicable device types, categories,
get_publish_metadata_lock_statusGet whether a publish profile's store metadata is locked for editing.
get_publish_detailsGet the publish flow run details for a single app version (status, timing, ordered steps with run history/artifacts/log resource IDs).
get_publish_step_logsGet 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.
publish_idThe publish flow run ID (the "id" field from get_publish_details). (string, required)
step_idOptional step ID. (string, optional)
get_publish_flowsGet the publish flows configured for a publish profile (name, ID, full flow document YAML).
start_publishSIDE 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). Regist
organization_pool_idOptional organization pool ID (e.g. UUID). (string, optional)
stop_publishSIDE 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=fal
get_store_profilesGet enterprise app store profiles for the current organization (paginated). Does not support search, but can filter by platform, publish type, and visibility. O
publish_typeOptional list of publish type codes to filter by. Allowed values: 1=Published to Beta, 2=Published to Live. (list of numbers, optional)
visibilityOptional filter for whether the profile is publicly listed (true=Listed, false=Unlisted). (boolean, optional)
get_store_profile_detailsGet a single enterprise app store profile by ID (with optional app versions pagination).
get_build_history_reportGet build history report, optionally filtered by date range, build profile, and organization. Paginated.
start_dateOptional start date (YYYY-MM-DD). Must be <= end_date if both are given. (string, optional)
end_dateOptional end date (YYYY-MM-DD). (string, optional)
build_profile_nameFilter by build profile name. (string, optional)
organization_idFilter by organization UUID. (string, optional)
get_build_queue_waiting_reportGet the build queue waiting report, optionally filtered by date range. Paginated. Note: on this endpoint, buildDuration means queue wait time in minutes, not ex
get_build_activity_logGet the build activity log (workflow/profile changes, CodePush releases, etc.), optionally filtered by date range and other parameters. Paginated.
emailFilter by acting user's email. (string, optional)
profile_nameFilter by publish profile name. (string, optional)
actionFilter by activity action code (integer; see PUBLISH_ACTIVITY_ACTIONS in the tool source for the full mapping). (number, optional)
get_build_insights_reportGet a computed Build Insights Report (Health Snapshot + Trends, Root Cause, Artifact Health, Workflow Quality, Queue Time, and Maturity Assessment analysis) ove
sectionsOptional list of sections to compute: health_snapshot, root_cause, artifact_health, workflow_quality, queue_time, maturity_assessment. Default: all six. (array
include_sub_orgsIf 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_reportGet daily usage report for distributed app versions. Paginated; supports filters by profile, OS, organization.
osFilter by OS ("ios" or "android"). (string, optional)
get_distribution_sent_reportGet daily usage report for distributed app sharing. Paginated; supports filters by profile, OS, organization.
get_enterprise_app_store_app_usage_reportGet app usage report for enterprise app store. start_date and end_date are required. Paginated.
get_publish_resign_reportGet publish resign report, optionally filtered by date range, app name, organization, and status. Paginated.
app_nameFilter by app name. (string, optional)
statusFilter by publish status (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)
get_publish_status_reportGet publish status report, optionally filtered by date range, app name, organization, and status. Paginated.
get_signing_reportGet signing report, optionally filtered by date range, organization, OS, and build status. Paginated.
build_statusFilter by build status (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)
get_signing_activity_logGet the signing activity log (e.g. certificate/provisioning profile/keystore expiry notices), optionally filtered by date range and other parameters. Paginated.
get_publish_activity_logGet the publish activity log (re-sign, publish flow events, etc.), optionally filtered by date range and other parameters. Paginated.

How to install the Appcircle MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use Appcircle MCP to CLI.”
  • “Use Appcircle MCP to Env.”
  • “Use Appcircle MCP to get build profiles.”

Frequently asked questions

MCP server for [Appcircle](https://appcircle.io): exposes Build, Signing Identities, Testing Distribution, Enterprise App Store, Publish to Stores, and Reporting Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.