Get build profiles for the current organization (paginated).

Returns a list of build profiles with their IDs, names, platform types, repository information, build status, and configuration details. Optionally filter by profile name using the search parameter.

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 by name (case-insensitive partial match). For example, search="iOS" will return profiles with "iOS" in their name.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of build profile objects), meta (count, page, page_size, search_term). - Error: success (false), error (tool, type, message, details). Profile objects exclude connectionEnvironmentKey and webhookSecret.

Examples: Get first page (default size 25): get_build_profiles() Get page 2 with 10 items: get_build_profiles(page=2, size=10) Search for iOS profiles: get_build_profiles(search="iOS")

Get a single build profile by ID, optionally including its build configurations.

Returns the build profile with the given ID, including name, platform type, repository information, build status, and optionally the list of configurations (when configurations=True, calls GET /build/v2/profiles/{profileId}/configurations). The returned profile excludes connectionEnvironmentKey and webhookSecret.

Args: profile_id: The build profile ID (e.g. UUID). configurations: If True, also fetch the profile's build configurations and include them in data.configurations. Default: False.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (build profile object; if configurations=True then data also has a "configurations" key with the list), meta (empty). - Error: success (false), error (tool, type, message, details). Profile object excludes connectionEnvironmentKey and webhookSecret.

Examples: Get details for a profile: get_build_profile_details(profile_id="uuid-here") Get profile with configurations: get_build_profile_details(profile_id="uuid", configurations=True)

Get a single build configuration by profile ID and configuration ID.

Returns the build configuration with the given IDs, including configuration name, platform settings, workflows, signing identities, distribution and publish profile references, and related metadata (item1: configuration object, item2: optional extra).

Args: profile_id: The build profile ID (e.g. UUID). configuration_id: The build configuration ID (e.g. UUID).

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (object with item1: configuration details, item2: optional), meta (empty). - Error: success (false), error (tool, type, message, details).

Examples: Get configuration details: get_build_configuration_details(profile_id="uuid", configuration_id="config-uuid")

Get workflows for a build profile by profile ID.

Returns the list of workflows associated with the given build profile, including workflow id, name, and last used time.

Args: profile_id: The build profile ID (e.g. UUID).

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of workflow objects), meta (count). - Error: success (false), error (tool, type, message, details).

Examples: Get workflows for a profile: get_build_profile_workflows(profile_id="uuid-here")

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: get_workflow_detail(profile_id="uuid", workflow_id="workflow-uuid")

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 pagination. Default when using pagination: 25. Values above 100 are capped at 100.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of commit objects with id, hash, message, author, email, commitDate, tags, builds, etc.), meta (when pagination used: page, page_size, page_count, total_count, enable_previous, enable_next; otherwise empty or minimal). - Error: success (false), error (tool, type, message, details).

Examples: Get commits (no pagination): get_commits_by_branch(branch_id="branch-uuid") Get first page of commits: get_commits_by_branch(branch_id="branch-uuid", page=1, size=25) Get page 2 with 10 items: get_commits_by_branch(branch_id="branch-uuid", page=2, size=10)

Get a single commit by commit ID (UUID) or by commit hash (git SHA).

Returns the commit with the given identifier, including hash, message, author, email, commit date, tags, and associated builds (with status, failed step, duration, artifacts, etc.). Provide either commit_id or commit_hash, not both.

Args: commit_id: The commit ID (UUID). Use when you have the commit's unique ID. commit_hash: The commit hash (git SHA, e.g. 40-char hex). Use when you have the repository commit hash.

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, builds, targetBranchId, pullNumber, commitStatus, description, etc.), meta (empty). - Error: success (false), error (tool, type, message, details).

Examples: Get by commit ID: get_commit_details(commit_id="f4e4d8f9-ae28-4e82-a7bd-5e02338c2260") Get by commit hash: get_commit_details(commit_hash="15d2bb0bac20cd8a564d4dbdf7bf2948321f7908")

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.

Args: page: Page number (1-based). Default: 1. size: Page size (1-100). Default: 25. Values above 100 are capped at 100.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of enterprise app store profile objects), meta (count, page, page_size). - Error: success (false), error (tool, type, message, details).

Examples: Get first page (default size 25): get_store_profiles() Get page 2 with 10 items: get_store_profiles(page=2, size=10)

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.

Args: profile_id: The enterprise app store 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: success (true), data (single store profile object with appVersions), meta (app-versions pagination). - Error: success (false), error (tool, type, message, details). Profile and app versions exclude signedCertThumbPrint. Meta contains page, page_size, total_count, etc.

Examples: Get profile details: get_store_profile_details(profile_id="uuid-here") Get first page of app versions (5 per page): get_store_profile_details(profile_id="uuid", page=1, size=5)

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.

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 code to filter by (single value). Allowed values: 0=Success, 1=Failed, 2=Canceled, 3=Timeout, 90=Waiting, 91=Running, 92=Completing, 99=Unknown, 200=NotStarted, 201=Stopped, 202=InProgress, 203=AwaitingResponse.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of publish profile objects), meta (page, page_size, platform_type, flow_status, pagination metadata). - Error: success (false), error (tool, type, message, details).

Examples: Get first page of iOS profiles: get_publish_profiles(platform_type="ios") Get page 2 with 10 items: get_publish_profiles(platform_type="android", page=2, size=10) Filter by flow status: get_publish_profiles(platform_type="ios", flow_status=0)

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 100 are capped at 100.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (single publish profile object with appVersions), meta (app-versions pagination, platform_type). - Error: success (false), error (tool, type, message, details). Profile and app versions exclude signedCertThumbPrint.

Examples: Get profile details: get_publish_profile_details(platform_type="ios", profile_id="uuid-here") Get first page of app versions (5 per page): get_publish_profile_details(platform_type="ios", profile_id="uuid", page=1, size=5)

Get build history report, optionally filtered by date range.

Retrieves paginated build history with build metadata, artifacts, duration, status, and optional filters by date range, build profile and organization. Called without start_date and end_date, returns every item in the report.

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 from 1, default: 1) size: Items per page (1-100, default: 50) build_profile_name: Filter by build profile name organization_id: Filter by organization UUID

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of build history records), meta (count, page, page_size, total_count, total_pages, has_more, next_page, filters). - Error: success (false), error (tool, type, message, details).

Examples: Get all build history (no date filter): get_build_history_report()

Get build history for last month:
    get_build_history_report(
        start_date="2024-11-01",
        end_date="2024-11-30"
    )

Filter by build profile:
    get_build_history_report(
        start_date="2024-01-01",
        end_date="2024-12-31",
        build_profile_name="RN076iOS"
    )

Get second page with custom size:
    get_build_history_report(
        start_date="2024-01-01",
        end_date="2024-12-31",
        page=2,
        size=25
    )

Get a computed Build Insights Report over build history: Health Snapshot + Trends, Root Cause, Artifact Health, Workflow Quality, Queue Time, and Maturity Assessment analysis, aggregated server-side.

Unlike get_build_history_report (which returns raw paginated records), this tool fetches every page internally, computes percentiles/grouping/MTTR/flaky detection in Python, and returns only the small aggregated result. Sections that can't be computed from the available data (e.g. a field stripped by an Appcircle role restriction) are omitted rather than rendered as zeros or fabricated, and flagged in meta.omitted_sections / meta.omitted_subsections. Only the current-period build history fetch is mandatory -- every other fetch (previous period, profiles, queue waiting, signing identities, per-profile workflow/trigger/configuration data) is best-effort: a 401/403 from a token lacking permission for that specific resource (e.g. an admin-only endpoint) omits just the dependent section/subsection instead of failing the whole call, and is listed in meta.failed_fetches.

A main-org access token sees build history spanning every sub-organization, but can only enumerate its own org's profiles (the Appcircle API itself enforces this -- not something this tool can fetch around). By default the report is scoped to the token's own organization: build records whose profile isn't in that token's own profile list are excluded before any section is computed, so every section always means the same scope. Set include_sub_orgs=True to keep cross-org records in history-derived metrics (Health Snapshot, Root Cause, Artifact Health, Speed/Reliability) -- Workflow Quality/Discipline/Security for those profiles still can't be resolved (the API limitation doesn't go away), so they're omitted for those specific profiles rather than fabricated, and listed in meta.unresolved_profiles. queue_time has no profile field to scope by, so it's always a tree-wide aggregate regardless of this flag.

Args: start_date: Optional start date (format: "YYYY-MM-DD") for the current period. end_date: Optional end date (format: "YYYY-MM-DD") for the current period. If both start_date and end_date are omitted, defaults to the last 30 days. If only one is given, the other is filled to a 30-day-wide window. sections: Optional list of sections to compute. Subset of ["health_snapshot", "root_cause", "artifact_health", "workflow_quality", "queue_time", "maturity_assessment"]. Defaults to all six. Invalid section names return a validation error. include_sub_orgs: If True, keep cross-org build records in history-derived metrics instead of filtering them to the token's own org (default False). See the note above on what stays unresolved either way.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (date_range, sections.health_snapshot, sections.root_cause, sections.artifact_health, sections.workflow_quality, sections.queue_time, sections.maturity_assessment), meta (requested_sections, omitted_sections, omitted_subsections, failed_fetches, cross_org_builds_excluded, unresolved_profiles). - Error: success (false), error (tool, type, message, details).

Examples: Full report, last 30 days: get_build_insights_report() Root cause only, custom range: get_build_insights_report( start_date="2026-01-01", end_date="2026-01-31", sections=["root_cause"] ) Include cross-org records from a main-org token: get_build_insights_report(include_sub_orgs=True)

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 from 1, default: 1) size: Items per page (1-100, default: 50) organization_id: Filter by organization UUID os: Filter by OS ("ios" or "android") build_status: Filter by build status. Allowed: 0=Success, 1=Failed, 2=Canceled, 3=Timeout, 90=Waiting, 91=Running, 92=Completing, 99=Unknown

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of signing report records), meta (count, page, page_size, total_count, total_pages, has_more, next_page, filters). - Error: success (false), error (tool, type, message, details).

Examples: Get all signing report (no date filter): get_signing_report()

Get signing report for last month:
    get_signing_report(
        start_date="2024-11-01",
        end_date="2024-11-30"
    )

Filter by OS and build status:
    get_signing_report(
        start_date="2024-01-01",
        end_date="2024-12-31",
        os="ios",
        build_status=0
    )

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") page: Page number (starts from 1, default: 1) size: Items per page (1-100, default: 50) profile_name: Filter by distribution profile name os: Filter by OS ("ios" or "android") organization_id: Filter by organization UUID

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of daily usage records), meta (count, page, page_size, total_count, total_pages, has_more, next_page, filters). - Error: success (false), error (tool, type, message, details).

Examples: Get all distribution app version report (no date filter): get_distribution_app_version_report()

Get report for last month:
    get_distribution_app_version_report(
        start_date="2024-11-01",
        end_date="2024-11-30"
    )

Filter by profile and OS:
    get_distribution_app_version_report(
        start_date="2024-01-01",
        end_date="2024-12-31",
        profile_name="Internal Testing",
        os="ios"
    )

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") page: Page number (starts from 1, default: 1) size: Items per page (1-100, default: 50) profile_name: Filter by distribution profile name os: Filter by OS ("ios" or "android") organization_id: Filter by organization UUID

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of daily usage records), meta (count, page, page_size, total_count, total_pages, has_more, next_page, filters). - Error: success (false), error (tool, type, message, details).

Examples: Get all distribution sent report (no date filter): get_distribution_sent_report()

Get report for last month:
    get_distribution_sent_report(
        start_date="2024-11-01",
        end_date="2024-11-30"
    )

Filter by profile and OS:
    get_distribution_sent_report(
        start_date="2024-01-01",
        end_date="2024-12-31",
        profile_name="Internal Testing",
        os="ios"
    )

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) organization_id: Optional filter by organization UUID

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of app usage records), meta (count, page, page_size, total_count, total_pages, has_more, next_page, filters). - Error: success (false), error (tool, type, message, details).

Examples: Get app usage for last month: get_enterprise_app_store_app_usage_report( start_date="2024-11-01", end_date="2024-11-30" )

Filter by organization:
    get_enterprise_app_store_app_usage_report(
        start_date="2024-01-01",
        end_date="2024-12-31",
        organization_id="49ddc35d-85e8-4898-a4f7-496b63660db4"
    )

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 (starts from 1, default: 1) size: Items per page (1-100, default: 50) app_name: Filter by app name organization_id: Filter by organization UUID status: Filter by publish status. Allowed: 0=Success, 1=Failed, 2=Canceled, 3=Timeout, 90=Waiting, 91=Running, 92=Completing, 99=Unknown, 200=NotStarted, 201=Stopped, 202=InProgress, 203=AwaitingResponse

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of publish status records), meta (count, page, page_size, total_count, total_pages, has_more, next_page, filters). - Error: success (false), error (tool, type, message, details).

Examples: Get all publish status report (no date filter): get_publish_status_report()

Get report for last month:
    get_publish_status_report(
        start_date="2024-11-01",
        end_date="2024-11-30"
    )

Filter by status (success only):
    get_publish_status_report(
        start_date="2024-01-01",
        end_date="2024-12-31",
        status=0
    )

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 (starts from 1, default: 1) size: Items per page (1-100, default: 50) app_name: Filter by app name organization_id: Filter by organization UUID status: Filter by resign status. Allowed: 0=waiting, 1=processing, 2=succeeded, 3=failed, 4=cancelled, 5=timeout

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of publish resign records), meta (count, page, page_size, total_count, total_pages, has_more, next_page, filters). - Error: success (false), error (tool, type, message, details).

Examples: Get all publish resign report (no date filter): get_publish_resign_report()

Get report for last month:
    get_publish_resign_report(
        start_date="2024-11-01",
        end_date="2024-11-30"
    )

Filter by status (succeeded only):
    get_publish_resign_report(
        start_date="2024-01-01",
        end_date="2024-12-31",
        status=2
    )

Get all bundle identifiers for the organization.

Returns the list of bundle identifiers (iOS/macOS app bundle IDs) registered in Appcircle, including id, name, identifier, platform, capabilities, and related metadata.

Takes no parameters.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of bundle identifier objects), meta (count). - Error: success (false), error (tool, type, message, details).

Examples: Get all bundle identifiers: get_bundle_identifiers()

Get all signing certificates for the organization.

Returns the list of signing certificates (e.g. distribution/development) registered in Appcircle. Sensitive fields (p12Password, p12Binary, metaData, thumbprint) are omitted from the response.

Takes no parameters.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of certificate objects), meta (count). - Error: success (false), error (tool, type, message, details).

Examples: Get all certificates: get_certificates()

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 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 (tool, type, message, details).

Examples: Get all provisioning profiles: get_provisioning_profiles() Filter by app: get_provisioning_profiles(app_id="com.example.myapp")

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.

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 by name (case-insensitive partial match). For example, search="iOS" will return profiles with "iOS" in their name.

Returns: Standard envelope (see docs/tool_contract.md): - Success: success (true), data (list of distribution profile objects), meta (count, page, page_size, search_term). - Error: success (false), error (tool, type, message, details). Profile objects exclude settings.password.

Examples: Get first page (default size 25): get_distribution_profiles() Get page 2 with 10 items: get_distribution_profiles(page=2, size=10) Search for iOS profiles: get_distribution_profiles(search="iOS")

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: success (true), data (single distribution profile object with appVersions), meta (app-versions pagination). - Error: success (false), error (tool, type, message, details). Profile object excludes settings.password. Meta contains page, page_size, total_count, etc.

Examples: Get profile details: get_distribution_profile_details(profile_id="uuid-here") Get first page of app versions (5 per page): get_distribution_profile_details(profile_id="uuid", page=1, size=5)