{
  "markdown": "<p align=\"center\">\n  <img width=\"20%\" src=\".github/assets/logo.webp\" alt=\"mcp-appstore-connect\" />\n</p>\n<p align=\"center\">\n  <h1 align=\"center\">App Store Connect MCP</h1>\n</p>\n<p align=\"center\">\n  App Store Connect in your AI agent. MCP server for the official App Store Connect API.\n</p>\n<div align=\"center\">\n\n[![npm version](https://badgen.net/npm/v/mcp-asc)](https://www.npmjs.com/package/mcp-asc)\n[![License](https://img.shields.io/npm/l/mcp-asc)](https://github.com/beautyfree/appstore-connect-mcp/blob/main/LICENSE)\n\n</div>\n\nA [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that connects [Cursor](https://cursor.com), [Claude Desktop](https://claude.ai), and other MCP clients to the official [App Store Connect API](https://developer.apple.com/documentation/appstoreconnectapi)—so you can manage iOS/macOS apps, TestFlight, in-app subscriptions, and store metadata via chat or automated tool calls instead of clicking through the App Store Connect UI.\n\n**Use it to:** list and inspect apps, builds, and beta groups · manage TestFlight testers and review submissions · create and update subscription groups and prices · edit App Store version localizations and \"What's New\" · download sales and finance reports · list Xcode schemes and CI products. All with JWT auth and the same API Apple's own tools use.\n\n## Install\n\n**Cursor (install link):**\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=app-store-connect&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1hc2MiXSwiZW52Ijp7IkFQUF9TVE9SRV9DT05ORUNUX0tFWV9JRCI6IllPVVJfS0VZX0lEIiwiQVBQX1NUT1JFX0NPTk5FQ1RfSVNTVUVSX0lEIjoiWU9VUl9JU1NVRVJfSUQiLCJBUFBfU1RPUkVfQ09OTkVDVF9QOF9QQVRIIjoiL3BhdGgvdG8veW91ci9hdXRoLWtleS5wOCIsIkFQUF9TVE9SRV9DT05ORUNUX1ZFTkRPUl9OVU1CRVIiOiJZT1VSX1ZFTkRPUl9OVU1CRVJfT1BUSU9OQUwifX0%3D)\n\n**Other clients (Claude Desktop, etc.):**\n\n```bash\nnpx add-mcp mcp-asc\n```\n\n## Configure\n\nAdd the server to your MCP config and set these environment variables:\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `APP_STORE_CONNECT_KEY_ID` | Yes | API Key ID from App Store Connect |\n| `APP_STORE_CONNECT_ISSUER_ID` | Yes | Issuer ID from App Store Connect |\n| `APP_STORE_CONNECT_P8_PATH` | Yes | Path to your `.p8` private key file |\n| `APP_STORE_CONNECT_VENDOR_NUMBER` | For reports | Needed for sales/finance reports |\n\nCreate an API key at [App Store Connect → Users and Access → Integrations → App Store Connect API](https://appstoreconnect.apple.com/access/integrations/api). Download the `.p8` and note Key ID and Issuer ID.\n\n**Example (stdio):**\n\n```json\n{\n  \"mcpServers\": {\n    \"app-store-connect\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-asc\"],\n      \"env\": {\n        \"APP_STORE_CONNECT_KEY_ID\": \"YOUR_KEY_ID\",\n        \"APP_STORE_CONNECT_ISSUER_ID\": \"YOUR_ISSUER_ID\",\n        \"APP_STORE_CONNECT_P8_PATH\": \"/path/to/AuthKey_XXXXX.p8\",\n        \"APP_STORE_CONNECT_VENDOR_NUMBER\": \"YOUR_VENDOR_NUMBER_OPTIONAL\"\n      }\n    }\n  }\n}\n```\n\n**Example (HTTP SSE):** Run `npm run build` then `npm run start:http`. Point your client at `http://localhost:3001/mcp` with the same env vars.\n\n## Tools\n\nTools are exposed in kebab-case. Use your MCP client to list them and see parameters. Summary by area:\n\n**Apps & metadata**\n- `list-apps`, `get-app`, `list-app-infos`, `get-app-info`, `get-app-availability`\n- `list-app-store-versions`, `get-app-store-version`, `create-app-store-version`, `update-app-store-version`\n- `list-app-store-version-localizations`, `list-app-categories`, `list-app-encryption-declarations`, `list-nominations`\n\n**TestFlight / Beta**\n- `list-beta-groups`, `get-beta-group`, `list-beta-testers`, `get-beta-tester`, `add-beta-testers-to-group`, `remove-beta-testers-from-group`\n- `list-builds`, `get-build`, `list-build-beta-details`, `list-pre-release-versions`, `get-pre-release-version`\n- `list-beta-app-localizations`, `list-beta-app-review-details`, `list-beta-app-review-submissions`, `list-beta-license-agreements`, `get-beta-license-agreement`, `update-beta-license-agreement`\n\n**Subscriptions**\n- `list-subscription-groups`, `list-subscription-group-subscriptions`, `get-subscription`, `create-subscription-group`, `create-subscription`\n- `create-subscription-availability`, `list-subscription-price-points`, `create-subscription-price`, `create-subscription-localization`\n\n**Store & review**\n- `list-review-submissions`, `get-review-submission`, `submit-for-review`, `list-customer-reviews`, `create-customer-review-response`\n- `get-app-store-review-detail`, `update-app-store-review-detail`\n\n**Other**\n- `list-bundle-ids`, `get-bundle-id` · `list-certificates`, `get-certificate` · `list-profiles` · `list-devices`, `get-device`\n- `list-users`, `get-user`, `list-user-invitations` · `list-territories` · `list-actors`, `get-actor`\n- `get-eula`, `update-eula` · `get-phased-release`, `create-phased-release` · `update-age-rating-declaration`\n- `list-schemes` (Xcode), `list-ci-products` (Xcode Cloud)\n- `download-sales-report`, `download-finance-report` (require `APP_STORE_CONNECT_VENDOR_NUMBER`)\n\n## Development\n\nBuilt with [xmcp](https://xmcp.dev/docs). One tool per file under `src/tools/`; each file exports `metadata` and a default handler.\n\n```bash\nnpm install\nnpm run build\nnpm run start:stdio   # or npm run start:http for HTTP transport\nnpm run dev            # watch + run\n```\n\nNode 20+.\n\n## Open Plugins\n\nThis repository now includes Open Plugins-compatible metadata and layout:\n\n- `.plugin/plugin.json` for plugin metadata\n- `.mcp.json` for MCP server wiring\n- `skills/app-store-connect/SKILL.md` for installable skill context\n\nOpen Plugins standard: [open-plugins.com](https://open-plugins.com/)\n\nYou can test locally by loading the plugin directory in a compatible host, for example:\n\n```bash\nclaude --plugin-dir .\n```\n\n## Listing in MCP catalogs\n\nTo add this server to the **official MCP Registry**, **Cursor MCP Directory**, **cursor.store**, and other catalogs, see [docs/REGISTRY.md](docs/REGISTRY.md).\n\n## License\n\nMIT.\n\n## Links\n\n- [Model Context Protocol](https://modelcontextprotocol.io)\n- [App Store Connect API](https://developer.apple.com/documentation/appstoreconnectapi)\n- [xmcp](https://xmcp.dev/docs)\n",
  "bytes": 6268,
  "sha": "cfadfa982a454eec2490b76a6b949724e2c9a1ea761e88ae3e6801816f852c88",
  "repo_slug": "beautyfree/appstore-connect-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_beautyfree_app_store_connect_e9367377/readme"
}