\n\n

Build

\n\n- **get_build_profiles** - Get build profiles for the current organization (paginated). Optionally filter by profile name.\n - **Access level:** read\n - `page`: Page number (1-based). Default: 1. (number, optional)\n - `size`: Page size (1-100). Default: 25. Values above 100 are capped at 100. (number, optional)\n - `search`: Optional search term to filter profiles by name (case-insensitive partial match). (string, optional)\n\n- **get_build_profile_details** - Get a single build profile by ID, optionally including its build configurations.\n - **Access level:** read\n - `profile_id`: The build profile ID (e.g. UUID). (string, required)\n - `configurations`: If true, also fetch the profile's build configurations. Default: false. (boolean, optional)\n\n- **get_build_configuration_details** - Get a single build configuration by profile ID and configuration ID.\n - **Access level:** read\n - `profile_id`: The build profile ID (e.g. UUID). (string, required)\n - `configuration_id`: The build configuration ID (e.g. UUID). (string, required)\n\n- **get_build_profile_workflows** - Get workflows for a build profile by profile ID.\n - **Access level:** read\n - `profile_id`: The build profile ID (e.g. UUID). (string, required)\n\n- **get_workflow_detail** - Get a single workflow by build profile ID and workflow ID.\n - **Access level:** read\n - `profile_id`: The build profile ID (e.g. UUID). (string, required)\n - `workflow_id`: The workflow ID (e.g. UUID). (string, required)\n\n- **get_commits_by_branch** - Get commits for a build branch (paginated).\n - **Access level:** read\n - `branch_id`: The branch ID (e.g. UUID). (string, required)\n - `page`: Page number (1-based). If provided with size, enables pagination. Default: 1. (number, optional)\n - `size`: Page size. If provided with page, enables pagination. Default: 25, max 100. (number, optional)\n\n- **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.\n - **Access level:** read\n - `commit_id`: The commit ID (UUID). (string, optional)\n - `commit_hash`: The commit hash (git SHA). (string, optional)\n\n

\n\n

Signing Identities

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

\n\n

Testing Distribution

\n\n- **get_distribution_profiles** - Get testing distribution profiles for the current organization (paginated). Optionally filter by profile name.\n - **Access level:** read\n - `page`: Page number (1-based). Default: 1. (number, optional)\n - `size`: Page size (1-100). Default: 25, max 100. (number, optional)\n - `search`: Optional search term to filter profiles by name. (string, optional)\n\n- **get_distribution_profile_details** - Get a single testing distribution profile by ID (with optional app versions pagination).\n - **Access level:** read\n - `profile_id`: The distribution profile ID (e.g. UUID). (string, required)\n - `page`: Page number for app versions (1-based). Default: 1. (number, optional)\n - `size`: Page size for app versions (1-100). Default: 25, max 100. (number, optional)\n\n

\n\n

Publish to Stores

\n\n- **get_publish_profiles** - Get publish profiles for the current organization for a given platform type (paginated). Optionally filter by flow status.\n - **Access level:** read\n - `platform_type`: Platform type of publish profiles (\"ios\" or \"android\"). (string, required)\n - `page`: Page number (1-based). Default: 1. (number, optional)\n - `size`: Page size (1-100). Default: 25, max 100. (number, optional)\n - `flow_status`: Optional flow status code to filter by (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)\n\n- **get_publish_profile_details** - Get a single publish profile by platform type and ID (with optional app versions pagination).\n - **Access level:** read\n - `platform_type`: Platform type (\"ios\" or \"android\"). (string, required)\n - `profile_id`: The publish profile ID (e.g. UUID). (string, required)\n - `page`: Page number for app versions (1-based). Default: 1. (number, optional)\n - `size`: Page size for app versions (1-100). Default: 25, max 100. (number, optional)\n\n

\n\n

Enterprise App Store

\n\n- **get_store_profiles** - Get enterprise app store profiles for the current organization (paginated).\n - **Access level:** read\n - `page`: Page number (1-based). Default: 1. (number, optional)\n - `size`: Page size (1-100). Default: 25, max 100. (number, optional)\n\n- **get_store_profile_details** - Get a single enterprise app store profile by ID (with optional app versions pagination).\n - **Access level:** read\n - `profile_id`: The enterprise app store profile ID (e.g. UUID). (string, required)\n - `page`: Page number for app versions (1-based). Default: 1. (number, optional)\n - `size`: Page size for app versions (1-100). Default: 25, max 100. (number, optional)\n\n

\n\n

Report

\n\n- **get_build_history_report** - Get build history report, optionally filtered by date range, build profile, and organization. Paginated.\n - **Access level:** read\n - `start_date`: Optional start date (YYYY-MM-DD). (string, optional)\n - `end_date`: Optional end date (YYYY-MM-DD). (string, optional)\n - `page`: Page number (default: 1). (number, optional)\n - `size`: Items per page (1-100, default: 50). (number, optional)\n - `build_profile_name`: Filter by build profile name. (string, optional)\n - `organization_id`: Filter by organization UUID. (string, optional)\n\n- **get_distribution_app_version_report** - Get daily usage report for distributed app versions. Paginated; supports filters by profile, OS, organization.\n - **Access level:** read\n - `start_date`: Optional start date (YYYY-MM-DD). (string, optional)\n - `end_date`: Optional end date (YYYY-MM-DD). (string, optional)\n - `page`: Page number (default: 1). (number, optional)\n - `size`: Items per page (1-100, default: 50). (number, optional)\n - `profile_name`: Filter by distribution profile name. (string, optional)\n - `os`: Filter by OS (\"ios\" or \"android\"). (string, optional)\n - `organization_id`: Filter by organization UUID. (string, optional)\n\n- **get_distribution_sent_report** - Get daily usage report for distributed app sharing. Paginated; supports filters by profile, OS, organization.\n - **Access level:** read\n - `start_date`: Optional start date (YYYY-MM-DD). (string, optional)\n - `end_date`: Optional end date (YYYY-MM-DD). (string, optional)\n - `page`: Page number (default: 1). (number, optional)\n - `size`: Items per page (1-100, default: 50). (number, optional)\n - `profile_name`: Filter by distribution profile name. (string, optional)\n - `os`: Filter by OS (\"ios\" or \"android\"). (string, optional)\n - `organization_id`: Filter by organization UUID. (string, optional)\n\n- **get_enterprise_app_store_app_usage_report** - Get app usage report for enterprise app store. start_date and end_date are required. Paginated.\n - **Access level:** read\n - `start_date`: Start date (YYYY-MM-DD). (string, required)\n - `end_date`: End date (YYYY-MM-DD). (string, required)\n - `page`: Page number (default: 1). (number, optional)\n - `size`: Items per page (1-100, default: 50). (number, optional)\n - `organization_id`: Optional filter by organization UUID. (string, optional)\n\n- **get_publish_resign_report** - Get publish resign report, optionally filtered by date range, app name, organization, and status. Paginated.\n - **Access level:** read\n - `start_date`: Optional start date (YYYY-MM-DD). (string, optional)\n - `end_date`: Optional end date (YYYY-MM-DD). (string, optional)\n - `page`: Page number (default: 1). (number, optional)\n - `size`: Items per page (1-100, default: 50). (number, optional)\n - `app_name`: Filter by app name. (string, optional)\n - `organization_id`: Filter by organization UUID. (string, optional)\n - `status`: Filter by resign status (0=waiting, 1=processing, 2=succeeded, 3=failed, 4=cancelled, 5=timeout). (number, optional)\n\n- **get_publish_status_report** - Get publish status report, optionally filtered by date range, app name, organization, and status. Paginated.\n - **Access level:** read\n - `start_date`: Optional start date (YYYY-MM-DD). (string, optional)\n - `end_date`: Optional end date (YYYY-MM-DD). (string, optional)\n - `page`: Page number (default: 1). (number, optional)\n - `size`: Items per page (1-100, default: 50). (number, optional)\n - `app_name`: Filter by app name. (string, optional)\n - `organization_id`: Filter by organization UUID. (string, optional)\n - `status`: Filter by publish status (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)\n\n- **get_signing_report** - Get signing report, optionally filtered by date range, organization, OS, and build status. Paginated.\n - **Access level:** read\n - `start_date`: Optional start date (YYYY-MM-DD). (string, optional)\n - `end_date`: Optional end date (YYYY-MM-DD). (string, optional)\n - `page`: Page number (default: 1). (number, optional)\n - `size`: Items per page (1-100, default: 50). (number, optional)\n - `organization_id`: Filter by organization UUID. (string, optional)\n - `os`: Filter by OS (\"ios\" or \"android\"). (string, optional)\n - `build_status`: Filter by build status (e.g. 0=Success, 1=Failed, 91=Running). (number, optional)\n\n

\n\n\n## Running the server\n\nFrom the repo root:\n\n```bash\npython -m src.server\n```\n\nOr after `pip install -e .`:\n\n```bash\nappcircle-mcp\n```\n\nThe server runs over stdio (or SSE/HTTP depending on how your client starts it).\n\n## Response format\n\nEvery tool returns a **standard envelope**:\n\n- **Success:** `{ \"success\": true, \"data\": , \"meta\": { ... } }` \n `data` is the tool result; `meta` is optional (e.g. `count`, `page`, `filters`).\n- **Error:** `{ \"success\": false, \"error\": { \"tool\", \"type\", \"message\", \"details\" } }` \n Same shape for all tools so clients can parse errors consistently.\n\nFull specification: [docs/tool_contract.md](https://github.com/appcircleio/appcircle-mcp/blob/main/docs/tool_contract.md).\n\n## Testing\n\nInstall with dev dependencies:\n\n```bash\npip install -e \".[dev]\"\n```\n\n### Unit tests (default)\n\nUse a mocked API; **no `APPCIRCLE_ACCESS_TOKEN`** needed. Default `pytest` only runs these (see `testpaths` in [pyproject.toml](https://github.com/appcircleio/appcircle-mcp/blob/main/pyproject.toml)):\n\n```bash\npytest test/unit/ -v\n```\n\n- Single file: `pytest test/unit/tools/build_module/test_get_build_profiles.py -v`\n- With coverage: `pytest test/unit/ --cov=src --cov-report=term-missing`\n\n### Integration tests\n\nCall the **real Appcircle API**. Set `APPCIRCLE_ACCESS_TOKEN` in the environment, then run:\n\n```bash\npytest test/integration/ -v\n```\n\n- All integration tests: `pytest test/integration/ -v`\n- By tool: `pytest test/integration/build_module/ -v`, `pytest test/integration/report/ -v`, etc.\n- By marker: `pytest -m integration -v` (when running from repo root; includes only integration tests if both unit and integration are collected)\n\nIf `APPCIRCLE_ACCESS_TOKEN` is not set, integration tests are **skipped** (no failure).\n\n**Optional env vars for integration tests** (when discovery fails or tests need real IDs; omit to skip those tests):\n\n| Variable | Description |\n|----------|-------------|\n| `APPCIRCLE_TEST_ORGANIZATION_ID` | Organization UUID. Used by `test_with_organization_id` (enterprise app store app usage report). |\n| `APPCIRCLE_TEST_BRANCH_ID` | Branch UUID. Used by get_commits_by_branch and related tests when no branch can be discovered from the API. |\n| `APPCIRCLE_TEST_COMMIT_ID` | Commit UUID. Used by get_commit_details tests when no commit can be discovered from the API. |\n\n## Security\n\nThis project depends on third-party open-source packages listed in\n[pyproject.toml](https://github.com/appcircleio/appcircle-mcp/blob/main/pyproject.toml). While we pin dependency version ranges and\nship a lockfile (`uv.lock`) with cryptographic hashes, these packages are\nmaintained independently and provided \"as-is.\" Appcircle makes no guarantees\nregarding the security or reliability of third-party dependencies.\n\nWe recommend auditing installed packages before use:\n\n```bash\nuv run pip-audit\n```\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","categoryDisplayName","Developer Tools","upstream",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":-5},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_92":57,"_93":57},"ratingAvg","reviewCount","topics",[],"license","MIT","language","Python","registryName","io.appcircle/appcircle-mcp","homepage","ENV",{"_105":106,"_107":108,"_109":110},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

Appcircle MCP