# Appcircle — how to use (mcp.ai)

Connect your Appcircle account and use 14 tools for developer tools straight from your AI agent. Connect with your own API key. Appcircle is an enterprise-grade mobile CI/CD platform that enables developers to build, test, and publish mobile applications efficiently, offering both cloud-based and self-hosted deployment options.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_appcircle?ms=1787295720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `appcircle_build_repo_webhook_callback_standard`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/appcircle`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/appcircle/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/appcircle/build/repo/webhook/callback/standard` — Trigger Appcircle builds via Git provider webhook callbacks. This action forwards webhook payloads from GitHub, GitLab, Bitbucket, or Azure DevOps to Appcircle's build webhook endpoint to automaticall
  - body: { payload: object, git_provider: string, organization_id: string }
- `POST https://api.mcp.ai/api/appcircle/build/webhook/custom/integration` — Triggers Appcircle builds via custom integration webhook endpoint by forwarding Git provider webhook payloads. This action is designed to receive and forward webhook payloads from Git providers (GitHu
  - body: { payload: object, version: string, git_provider: string, integration_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/appcircle/distribution/list/profiles` — List all distribution profiles for the authenticated organization. Distribution profiles are used to manage and distribute app builds to testers. This endpoint supports pagination, sorting, and filter
  - body: { page?: integer, size?: integer, sort?: string, search?: string }
- `POST https://api.mcp.ai/api/appcircle/get/distribute/sent/profiles` — Get distinct profile names for App Sharing Report filter. Returns a list of unique profile names that can be used to filter app sharing reports within the specified date range and organization. Use th
  - body: { endDate?: string, startDate?: string, organizationId?: string }
- `POST https://api.mcp.ai/api/appcircle/get/publish/activity/report` — Retrieve the publish activity report for your organization. Returns paginated list of publish activities with filtering options by date range, platform, action type, and organization. Use this to moni
  - body: { Page?: integer, Size?: integer, Sort?: string, email?: string, action?: string, endDate?: string, platform?: string, startDate?: string, profileName?: string, organizationId?: string, organizationName?: string }
- `POST https://api.mcp.ai/api/appcircle/list/build/profiles` — List all build profiles for the authenticated organization. Build profiles define the configuration for building mobile applications. Use this to discover available build profiles and their IDs before
- `POST https://api.mcp.ai/api/appcircle/list/bundle/identifiers` — List all bundle identifiers in Appcircle. Returns all bundle identifiers configured in your organization, including their platforms, capabilities, and associated credentials. Use this to discover avai
- `POST https://api.mcp.ai/api/appcircle/list/organizations` — List organizations accessible to the authenticated user. Returns a paginated list of organizations with their details including ID, name, logo URL, and SSO status. Supports search filtering and pagina
  - body: { page?: integer, search?: string, perPage?: integer }
- `POST https://api.mcp.ai/api/appcircle/list/store/profiles` — List all Enterprise App Store profiles for the authenticated organization. Enterprise App Store profiles are used to distribute apps internally. Use this to discover available store profiles and their
- `POST https://api.mcp.ai/api/appcircle/rename/variable/group` — Tool to rename an environment group (variable group) in Appcircle. Use when you need to update the name of an existing variable group to better reflect its purpose or environment.
  - body: { name?: string, variableGroupId: string }
- `POST https://api.mcp.ai/api/appcircle/store/in/app/auth/token` — Tool to fetch an access token for Enterprise App Store in-app updates. Use when you have the enterprise store profileId and secret and need to obtain a bearer token for subsequent update requests.
  - body: { Secret: string, storeUrl: string, ProfileId: string }
- `POST https://api.mcp.ai/api/appcircle/store/in/app/download/version/with/user` — Tool to download a specific in-app store version and attribute the download to a user for reporting. Use when triggering an in-app update download after obtaining an access token.
  - body: { store_url: string, user_email: string, version_id: string, access_token: string }
- `POST https://api.mcp.ai/api/appcircle/store/inapp/list/app/versions` — Tool to list available app versions for the Enterprise App Store profile. Use when fetching available in-app update versions.
  - body: { storeUrl: string, accessToken?: string }
- `POST https://api.mcp.ai/api/appcircle/store/list/profile/app/versions/v2` — Tool to list app versions under a given store profile. Use when you need to fetch all versions for a specific Enterprise App Store profile after obtaining its ID.
  - body: { accept?: string, profileId: string, Authorization?: string }

## Example prompts
- "What can I do in Appcircle?"
- "Show me a summary of my Appcircle account"

## More
- Page: https://mcp.ai/appcircle
- Agent spec (llms.txt): https://mcp.ai/appcircle/llms.txt
- Postman collection: https://mcp.ai/appcircle/postman.json