Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CODEMAGIC_API_KEY | Yes | Your Codemagic API key, available from Codemagic User Settings -> Integrations -> Codemagic API. | |
| CODEMAGIC_DEFAULT_APP_ID | No | Optional default application ID to use when a tool requires an app_id and none is provided. If not set, the server will list apps or prompt for selection when multiple are found. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_apps | List all applications in your Codemagic account. |
| get_app | Get details of a specific application by its ID. Args: app_id: The Codemagic application ID. |
| add_app | Add a new public repository to Codemagic. Args: repository_url: The HTTPS URL of the public Git repository. |
| delete_app | Delete an application from Codemagic. Args: app_id: The Codemagic application ID. |
| add_private_app | Add a new private repository to Codemagic using an SSH key. Args: repository_url: The SSH URL of the private Git repository. ssh_key_data: Base64-encoded SSH private key. ssh_passphrase: Optional passphrase for the SSH key. project_type: Optional project type (e.g. "flutter-app", "react-native"). team_id: Optional team ID to add the app to. |
| list_builds | List Codemagic builds, optionally filtered by app, branch, and/or tag. Args: app_id: Optional app ID to filter builds. If omitted, returns builds across all apps. branch: Optional branch name to filter builds (e.g. "main"). tag: Optional tag name to filter builds (e.g. "release_v5.57.2"). limit: Number of builds per page (default 10). page: Page number to retrieve, starting from 1 (default 1). |
| get_build | Get details and status of a specific Codemagic build. Always includes a step summary (total, success, failed, skipped counts). Set include_steps=True to also get the full list of steps with their IDs, which can then be used with get_step_logs. Args: build_id: The Codemagic build ID. include_steps: If True, include full step list with IDs. Default False. |
| trigger_build | Trigger a new build for a Codemagic application. Args: app_id: The Codemagic application ID. workflow_id: The workflow ID to run. branch: Git branch to build (mutually exclusive with tag). tag: Git tag to build (mutually exclusive with branch). environment: Optional environment variables to override, e.g. {"variables": {"KEY": "value"}}. instance_type: Optional machine instance type to use for the build. |
| cancel_build | Cancel a running Codemagic build. Args: build_id: The build ID to cancel. |
| get_build_logs | Get a step-by-step status summary of a Codemagic build. Returns each build step with its name, ID, and status (✅ success, ❌ failed, ⏭ skipped). Args: build_id: The Codemagic build ID. statuses: Optional list of statuses to filter by. Valid values: "success", "failed", "skipped", "canceled". If omitted, all steps are returned. |
| get_step_logs | Get the raw logs for a specific build step. Use get_build_logs first to see all step IDs, then call this to drill into a specific step. Args: build_id: The Codemagic build ID. step_id: The step ID (from get_build_logs output). |
| list_build_artifacts | List all artifacts produced by a Codemagic build. Args: build_id: The Codemagic build ID. |
| get_artifact_url | Get the download URL for a build artifact. Args: secure_filename: The secure filename of the artifact (from build results). |
| create_artifact_public_url | Create a time-limited public URL for a build artifact. Args: secure_filename: The secure filename of the artifact (from build results). expires_at: Expiry time as a UNIX timestamp (seconds since epoch). |
| list_caches | List all build caches for a Codemagic application. Args: app_id: The Codemagic application ID. |
| delete_all_caches | Delete all build caches for a Codemagic application. Args: app_id: The Codemagic application ID. |
| delete_cache | Delete a specific build cache for a Codemagic application. Args: app_id: The Codemagic application ID. cache_id: The cache ID to delete. |
| list_variables | List all environment variables for a Codemagic application. Args: app_id: The Codemagic application ID. |
| add_variable | Add an environment variable to a Codemagic application. Args: app_id: The Codemagic application ID. key: The variable name. value: The variable value. group: The variable group name. secure: Whether the variable should be encrypted (e.g. for secrets/tokens). |
| update_variable | Update an existing environment variable for a Codemagic application. Args: app_id: The Codemagic application ID. variable_id: The variable ID to update. key: The variable name. value: The new variable value. group: The variable group name. secure: Whether the variable should be encrypted. |
| delete_variable | Delete an environment variable from a Codemagic application. Args: app_id: The Codemagic application ID. variable_id: The variable ID to delete. |
| list_webhooks | List all webhooks configured for a Codemagic application. Args: app_id: The Codemagic application ID. |
| add_webhook | Add a webhook to a Codemagic application. Args: app_id: The Codemagic application ID. url: The URL to send webhook payloads to. events: List of events to subscribe to (e.g. ["build.finished", "build.started"]). |
| delete_webhook | Delete a webhook from a Codemagic application. Args: app_id: The Codemagic application ID. webhook_id: The webhook ID to delete. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |