Appcircle MCP

Get commits for a build branch (paginated). Returns a list of commits for the given branch ID, including commit hash, message, author, commit date, tags, and associated builds. When page and size are provided, the API returns pagination metadata (page, perPage, pageCount, totalCount, enablePrevious, enableNext) which is included in meta. Args: branch_id: The branch ID (e.g. UUID). page: Page number (1-based). If provided with size, enables pagination and returns pagination metadata in meta. Default when using pagination: 1. size: Page size. If provided with page, enables …

Get daily usage report for distributed app versions. Retrieves paginated daily usage data for app versions distributed via distribution profiles. Called without start_date and end_date, returns every item in the report. Supports filtering by profile, OS, and organization. IMPORTANT: Results are paginated by default to prevent token limit issues. Default page size is 50 items. Use page parameter to retrieve additional results. Args: start_date: Optional start date (format: "YYYY-MM-DD", e.g., "2024-01-01") end_date: Optional end date (format: "YYYY-MM-DD", e.g., "2024-12-31") pag…

Get a single testing distribution profile by ID (with optional app versions pagination). Returns the distribution profile with the given ID, including name, settings, and a paginated list of app versions. Use page and size to paginate app versions. The returned profile excludes settings.password. Args: profile_id: The distribution profile ID (e.g. UUID). page: Page number for app versions (1-based). Default: 1. size: Page size for app versions (1-100). Default: 25. Values above 100 are capped at 100. Returns: Standard envelope (see docs/tool_contract.md): - Success: succ…

Get testing distribution profiles for the current organization (paginated). Returns a list of distribution profiles with their IDs, names, iOS and Android app versions, settings details, and testing group information. Optionally filter by profile name using the search parameter, and/or by platform and authentication type. Optionally sort. Args: page: Page number (1-based). Default: 1. size: Page size (1-100). Default: 25. Values above 100 are capped at 100. search: Optional search term to filter profiles (case-insensitive partial match on profile name; the API's searc…

Get daily usage report for distributed app sharing. Retrieves paginated daily usage data for app sharing (distribute-sent) via distribution profiles. Called without start_date and end_date, returns every item in the report. Supports filtering by profile, OS, and organization. IMPORTANT: Results are paginated by default to prevent token limit issues. Default page size is 50 items. Use page parameter to retrieve additional results. Args: start_date: Optional start date (format: "YYYY-MM-DD", e.g., "2024-01-01") end_date: Optional end date (format: "YYYY-MM-DD", e.g., "2024-12-31") …

Get app usage report for enterprise app store. Retrieves paginated daily app usage data for the enterprise app store. start_date and end_date are required. Supports optional filter by organization. IMPORTANT: Results are paginated by default to prevent token limit issues. Default page size is 50 items. Use page parameter to retrieve additional results. Args: start_date: Start date (format: "YYYY-MM-DD", e.g., "2024-01-01") end_date: End date (format: "YYYY-MM-DD", e.g., "2024-12-31") page: Page number (starts from 1, default: 1) size: Items per page (1-100, default: 50) …

Get Microsoft Intune app metadata for a single app version. Returns the Intune app record synced for this app version: display name, description, publisher/owner/developer, bundle ID, version, publishing state, applicable device types, categories, and Intune-side timestamps. Args: platform_type: Platform type ("ios" or "android"). profile_id: The publish profile ID (e.g. UUID). app_version_id: The app version ID (e.g. UUID). Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (Intune metadata object: id, profileId, appVersionId, …

Get all keystores for the organization. Returns the list of keystores (e.g. Android signing keystores) registered in Appcircle. Sensitive fields (password, aliasPassword, binary, checkSum, sha256FingerPrint) are omitted from the response. Takes no parameters. Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of keystore objects), meta (count). - Error: success (false), error (tool, type, message, details). Examples: Get all keystores: get_keystores()

Get the most recent commit on a build branch. Returns the latest commit for the given branch ID, including commit hash, message, author, commit date, and tags. Args: branch_id: The branch ID (e.g. UUID). Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (commit object with id, organizationId, profileId, branchId, hash, message, author, eMail, commitDate, tags, targetBranchId, targetHash, pullNumber), meta (empty). - Error: success (false), error (tool, type, message, details). Examples: Get the last commit on a branch: g…

Get the available store metadata locales for a single app version. Returns each locale's display name, code, whether it has been localized (has store listing content filled in), and whether it's the app's primary locale. Args: platform_type: Platform type ("ios" or "android"). profile_id: The publish profile ID (e.g. UUID). app_version_id: The app version ID (e.g. UUID). Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of locale objects: name, code, localized, isPrimary), meta (count). - Error: success (false), error…

Get provisioning profiles for the organization. Returns the list of provisioning profiles (e.g. iOS/macOS) registered in Appcircle. Sensitive/large fields (binary, metaData, certificateThumbPrints, provisionedDevices, connectApiKeyId) are omitted from the response. Optionally filter by app (bundle) ID. Args: app_id: Optional app (bundle) ID to filter provisioning profiles (e.g. com.example.app). Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of provisioning profile objects), meta (count, filters). - Error: success (false), error…

Get the publish activity log, optionally filtered by date range and other parameters. Retrieves paginated publish activity records (re-sign, publish flow events, etc.), each with the acting user, publish profile, an action code, and a human-readable description. Called without start_date and end_date, returns every item in the log. IMPORTANT: Results are paginated by default to prevent token limit issues. Default page size is 50 items. Use page parameter to retrieve additional results. Args: start_date: Optional start date (format: "YYYY-MM-DD"). Must be <= end_date if both are given. …

Get the publish flow run details for a single app version. Returns the publish flow's status, timing, and its ordered steps, each with the step's component, status, run history (flowStepHistories, with log resource IDs and artifacts), and inputs/outputs. Args: platform_type: Platform type ("ios" or "android"). profile_id: The publish profile ID (e.g. UUID). app_version_id: The app version ID (e.g. UUID). Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (publish flow object: id, profileId, appversionId, name, startedOn, complet…

Get the publish flows configured for a publish profile. Returns each publish flow's name, ID, and full flow document (YAML text defining the flow's ordered steps, each step's component/version/inputs/ outputs). Args: platform_type: Platform type ("ios" or "android"). profile_id: The publish profile ID (e.g. UUID). Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of flow objects: organizationId, profileId, flowName, flowDocument, id, events), meta (count). - Error: success (false), error (tool, type, message, details). E…

Get whether a publish profile's store metadata is locked for editing. A locked profile's metadata (app review info, localizations, release info, etc.) cannot be changed until unlocked. Args: platform_type: Platform type ("ios" or "android"). profile_id: The publish profile ID (e.g. UUID). Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data ({"locked": <bool>}), meta (empty). - Error: success (false), error (tool, type, message, details). Examples: Get lock status: get_publish_metadata_lock_status(platform_type="ios", profile_id="u…

Get a single publish profile by platform type and ID (with optional app versions pagination). Returns the publish profile with the given ID for the given platform, including name, configuration, and a paginated list of app versions. Use page and size to paginate app versions. The returned profile and each app version exclude signedCertThumbPrint. Args: platform_type: Platform type ("ios" or "android"). profile_id: The publish profile ID (e.g. UUID). page: Page number for app versions (1-based). Default: 1. size: Page size for app versions (1-100). Default: 25. Values above 10…

Get publish profiles for the current organization for a given platform type (paginated). Returns a list of publish profiles with their IDs, names, app versions, version information, flow status information, and profile settings. Optionally filter by flow status, target marketplace, release-candidate binary presence, and store status. Optionally sort. Args: platform_type: Platform type of publish profiles ("ios" or "android"). page: Page number (1-based). Default: 1. size: Page size (1-100). Default: 25. Values above 100 are capped at 100. flow_status: Optional flow status cod…

Get publish resign report, optionally filtered by date range and other parameters. Retrieves paginated publish resign data. Called without start_date and end_date, returns every item in the report. Supports filtering by app name, organization, and status. IMPORTANT: Results are paginated by default to prevent token limit issues. Default page size is 50 items. Use page parameter to retrieve additional results. Args: start_date: Optional start date (format: "YYYY-MM-DD", e.g., "2024-01-01") end_date: Optional end date (format: "YYYY-MM-DD", e.g., "2024-12-31") page: Page number (s…

Get publish status report, optionally filtered by date range and other parameters. Retrieves paginated publish status data. Called without start_date and end_date, returns every item in the report. Supports filtering by app name, organization, and status. IMPORTANT: Results are paginated by default to prevent token limit issues. Default page size is 50 items. Use page parameter to retrieve additional results. Args: start_date: Optional start date (format: "YYYY-MM-DD", e.g., "2024-01-01") end_date: Optional end date (format: "YYYY-MM-DD", e.g., "2024-12-31") page: Page number (s…

Get the logs for a publish flow run, optionally scoped to a single step. The log returned for a given step_id may include other steps of the same publish flow run in the same log text (Appcircle stores one combined log per run). By default returns only the tail of the log (last 200 lines, capped at 64 KB) to avoid flooding the model's context. Pass full_log=True for the entire log instead (still capped at 256 KB as a safety net). Pass step to scope the output to one workflow step's log block, matched by its exact name as it appears in the log (e.g. "Send to Microsoft Intune") -- the log marks…

Get the signing activity log, optionally filtered by date range and other parameters. Retrieves paginated signing activity records (e.g. certificate/provisioning profile/keystore expiry notices), each with the affected signing identity, an action code, and a human-readable description. Called without start_date and end_date, returns every item in the log. IMPORTANT: Results are paginated by default to prevent token limit issues. Default page size is 50 items. Use page parameter to retrieve additional results. Args: start_date: Optional start date (format: "YYYY-MM-DD"). Must be <= end_d…

Get signing report, optionally filtered by date range and other parameters. Retrieves paginated signing report data. Called without start_date and end_date, returns every item in the report. Supports filtering by organization, OS, and build status. IMPORTANT: Results are paginated by default to prevent token limit issues. Default page size is 50 items. Use page parameter to retrieve additional results. Args: start_date: Optional start date (format: "YYYY-MM-DD", e.g., "2024-01-01") end_date: Optional end date (format: "YYYY-MM-DD", e.g., "2024-12-31") page: Page number (starts f…

Get a single enterprise app store profile by ID (with optional app versions pagination). Returns the enterprise app store profile with the given ID, including name, configuration, and a paginated list of app versions. Use page and size to paginate app versions. The returned profile and each app version exclude signedCertThumbPrint. Each app version's publishType field is an int: see APP_VERSION_PUBLISH_TYPES for the mapping (0=None, 1=Beta, 2=Live). Args: profile_id: The enterprise app store profile ID (e.g. UUID). page: Page number for app versions (1-based). Default: 1. size: P…

Get enterprise app store profiles for the current organization (paginated). Returns a list of enterprise app store profiles with their IDs, names, and configuration details. This tool does not support search filtering, but can filter by platform, publish type, and visibility. Optionally sort. Args: page: Page number (1-based). Default: 1. size: Page size (1-100). Default: 25. Values above 100 are capped at 100. platform_type: Optional list of platform codes to filter by. Allowed values: 1=iOS, 2=Android. publish_type: Optional list of publish type codes to filter by. …

Get all testing distribution groups for the organization. Returns each testing group's ID, name, member tester emails, group type, and (for externally-synced groups) external group name. Takes no parameters. Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of testing group objects), meta (count). - Error: success (false), error (tool, type, message, details). Examples: Get all testing groups: get_testing_groups()

Get all build environment variable groups for the organization. Returns each variable group's ID, name, sub-organization sharing settings, and its variables (key, value, isSecret, isFile). Secret variable values are already redacted by the API (empty string when isSecret is true). Takes no parameters. Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of variable group objects), meta (count). - Error: success (false), error (tool, type, message, details). Examples: Get all variable groups: get_variable_groups()

Get a single workflow by build profile ID and workflow ID. Returns the workflow with the given IDs, including workflow name, workflow document (YAML definition of steps), and last used time. Args: profile_id: The build profile ID (e.g. UUID). workflow_id: The workflow ID (e.g. UUID). Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (workflow object with id, profileId, workflowName, workflowDocument, lastUsedTime, etc.), meta (empty). - Error: success (false), error (tool, type, message, details). Examples: Get workflow detail: …

SIDE EFFECT: Sends a distribution app version to testers, notifying them with the given message. This is a write/action tool -- it dispatches a real notification/distribution task, it does not just read data. Args: profile_id: The distribution profile ID (e.g. UUID). app_version_id: The app version ID (e.g. UUID). message: The notification message shown to testers. 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). Returns: Standard envelope (see docs/tool_contr…

SIDE EFFECT: Starts a publish flow run (or restarts it from a specific step). This is a write/action tool -- it begins real publishing work (e.g. uploading to the App Store/Play Store/Intune), it does not just read data. Args: platform_type: Platform type ("ios" or "android"). profile_id: The publish profile ID (e.g. UUID). publish_id: The publish flow run ID (the "id" field from get_publish_details). step_id: Optional step ID (a step's "id" field from get_publish_details' steps list) to start from that step instead of the beginning of the flow. organization_pool_i…

SIDE EFFECT: Cancels a running publish flow run. This is a write/action tool -- it stops real, in-progress publishing work; it cannot be resumed afterward. Args: platform_type: Platform type ("ios" or "android"). profile_id: The publish profile ID (e.g. UUID). publish_id: The publish flow run ID (the "id" field from get_publish_details). step_id: Optional step ID (a step's "id" field from get_publish_details' steps list). organization_pool_id: Optional organization pool ID (e.g. UUID). Returns: Standard envelope (see docs/tool_contract.md): - Success: success (tru…

SIDE EFFECT: Starts a new real build run on Appcircle. This is a write/action tool -- it queues an actual build (consuming build minutes/credits), it does not just read data. Trigger a new build either on a branch (latest synced commit) or for one specific commit. Exactly one of these two modes must be used: - Branch mode (default): requires profile_id and workflow_id. branch_name is optional (falls back to the profile's default branch if omitted). - Commit mode: requires commit_id (the commit's own id, e.g. from get_last_commit/get_commits_by_branch/get_commit_details -- not the git ha…

SIDE EFFECT: Overwrites the release notes ("message") shown to testers for a distribution app version. This is a write tool -- it replaces the existing release notes text. Args: profile_id: The distribution profile ID (e.g. UUID). app_version_id: The app version ID (e.g. UUID). message: The new release notes text. Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (the updated app version object, excluding certThumbPrints), meta (empty). - Error: success (false), error (tool, type, message, details). type is invalid_state …