Appcircle MCP Server

MCP server for [Appcircle](https://appcircle.io): exposes Build, Signing Identities, Testing Distribution, Enterprise App Store, Publish to Stores

Remote serverstreamable-httpPython

What is the Appcircle MCP MCP server?

Appcircle MCP MCP server is a hosted integration for AI assistants that speak the Model Context Protocol. MCP server for Appcircle: exposes Build, Signing Identities, Testing Distribution, Enterprise App Store, Publish to Stores, and Reporting tools to any MCP-capable client (Claude Desktop, Cursor, VS Code, etc.). The.

What the assistant can call

Once Appcircle MCP is connected, these are the calls the assistant has available:

  • CLI — ** --exclude toolset1 toolset2 or --exclude-toolsets toolset1,toolset2
  • Env — ** APPCIRCLE_EXCLUDED_TOOLSETS=build_module,report
  • get_build_profiles — Get build profiles for the current organization (paginated). Optionally filter by profile name
  • page — Page number (1-based). Default: 1. (number, optional)
  • size — Page size (1-100). Default: 25. Values above 100 are capped at 100. (number, optional)
  • search — Optional search term to filter profiles by name (case-insensitive partial match). (string, optional)
  • get_build_profile_details — Get a single build profile by ID, optionally including its build configurations
  • profile_id — The build profile ID (e.g. UUID). (string, required)
  • configurations — If true, also fetch the profile's build configurations. Default: false. (boolean, optional)
  • get_build_configuration_details — Get a single build configuration by profile ID and configuration ID
  • configuration_id — The build configuration ID (e.g. UUID). (string, required)
  • get_build_profile_workflows — Get workflows for a build profile by profile ID

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

Configuration and credentials

You will need 6 environment variables: APPCIRCLE_ACCESS_TOKEN, APPCIRCLE_API_URL, APPCIRCLE_MCP_ALLOWED_HOST, APPCIRCLE_TEST_ORGANIZATION_ID, APPCIRCLE_TEST_BRANCH_ID, APPCIRCLE_TEST_COMMIT_ID. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Choosing this one

Among the planning and project tracking options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Appcircle MCP's toolset — CLI, Env, get_build_profiles and 11 more — is a fair guide to whether it matches your workflow. It is maintained by appcircleio; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Appcircle MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the appcircle mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
CLI** --exclude toolset1 toolset2 or --exclude-toolsets toolset1,toolset2
Env** APPCIRCLE_EXCLUDED_TOOLSETS=build_module,report
get_build_profilesGet build profiles for the current organization (paginated). Optionally filter by profile name.
pagePage number (1-based). Default: 1. (number, optional)
sizePage size (1-100). Default: 25. Values above 100 are capped at 100. (number, optional)
searchOptional search term to filter profiles by name (case-insensitive partial match). (string, optional)
get_build_profile_detailsGet a single build profile by ID, optionally including its build configurations.
profile_idThe build profile ID (e.g. UUID). (string, required)
configurationsIf true, also fetch the profile's build configurations. Default: false. (boolean, optional)
get_build_configuration_detailsGet a single build configuration by profile ID and configuration ID.
configuration_idThe build configuration ID (e.g. UUID). (string, required)
get_build_profile_workflowsGet workflows for a build profile by profile ID.
get_workflow_detailGet a single workflow by build profile ID and workflow ID.
workflow_idThe workflow ID (e.g. UUID). (string, required)

How to install the Appcircle MCP MCP server

{
  "mcpServers": {
    "appcircle": {
      "command": "appcircle-mcp",
      "args": ["--exclude", "report"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
APPCIRCLE_ACCESS_TOKENCredential the server authenticates with.Yes
APPCIRCLE_API_URLEndpoint or connection string the server talks to.Yes
APPCIRCLE_MCP_ALLOWED_HOSTEndpoint or connection string the server talks to.Optional
APPCIRCLE_TEST_ORGANIZATION_IDConfiguration value read at startup.Optional
APPCIRCLE_TEST_BRANCH_IDConfiguration value read at startup.Optional
APPCIRCLE_TEST_COMMIT_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use Appcircle MCP to CLI.
  • Use Appcircle MCP to Env.
  • Use Appcircle MCP to get build profiles.

Frequently asked questions

It connects Appcircle MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (CLI, Env, get_build_profiles, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Appcircle MCP directly.