trackmcp
Back to directory
trialanderrorai

appstore-connect-mcp

View on GitHub

MCP server for App Store Connect - reliable bridge between iOS metrics and AI assistants

4 stars TypeScriptAI & Machine Learning Updated Sep 18, 2025

Documentation

App Store Connect MCP Server — Code Mode

923 endpoints. 2 tools. The spec IS the implementation.

TypeScript
MCP SDK
License: MIT
API Version

The Problem

Traditional MCP servers wrap each API endpoint as a separate tool. Apple's App Store Connect API has 923 endpoints. That means 923 tool definitions, ~100K+ context tokens, and a new release every time Apple adds an endpoint.

The Solution

Code Mode: 2 tools replace 923.

ToolWhat It Does
`search(code)`Write JS to query Apple's OpenAPI spec. Discover endpoints, check parameters, read schemas.
`execute(code)`Write JS to call the API. Auth is automatic. Chain multiple calls.

The LLM writes the query. The spec IS the implementation. Adding endpoints = Apple updates their spec. Zero code changes on our side.

code
Traditional MCP:  923 endpoints → 923 tools → ~100K tokens → constant maintenance
Code Mode:        923 endpoints → 2 tools   → ~1K tokens   → zero maintenance

Quick Start

1. Get App Store Connect credentials

1. Go to App Store Connect → Users and Access → Integrations → Keys

2. Click "+" to generate a new key (Admin or Finance role)

3. Download the `.p8` file (only downloadable once!)

4. Note your Key ID and Issuer ID

2. Install via Claude Code

bash
claude mcp add appstore-connect -s user \
  -e APP_STORE_KEY_ID=YOUR_KEY_ID \
  -e APP_STORE_ISSUER_ID=YOUR_ISSUER_ID \
  -e APP_STORE_P8_PATH=/absolute/path/to/AuthKey_XXXXXXXXXX.p8 \
  -e APP_STORE_VENDOR_NUMBER=YOUR_VENDOR_NUMBER \
  -- npx -y @trialanderror-ai/appstore-connect-mcp

`-s user` makes the server available across all your projects. Drop `-e APP_STORE_VENDOR_NUMBER` if you don't need financial reports.

Or skip the env-var inline form and set them in your shell / MCP config (see below).

3. Configure credentials

Three required env vars (one optional):

VariableDescription
`APP_STORE_KEY_ID`10-character key ID
`APP_STORE_ISSUER_ID`UUID issuer ID
`APP_STORE_P8_PATH`Absolute path to your `.p8` file
`APP_STORE_VENDOR_NUMBER` *(optional)*Required for financial reports

Configure for Claude Code

Either set env vars in your shell, or pass them via `.mcp.json`:

json
{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "@trialanderror-ai/appstore-connect-mcp"],
      "env": {
        "APP_STORE_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_P8_PATH": "/path/to/AuthKey_XXXXXXXXXX.p8",
        "APP_STORE_VENDOR_NUMBER": "YOUR_VENDOR_NUMBER"
      }
    }
  }
}

Configure for Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

json
{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "@trialanderror-ai/appstore-connect-mcp"],
      "env": {
        "APP_STORE_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_P8_PATH": "/path/to/AuthKey_XXXXXXXXXX.p8"
      }
    }
  }
}

Build from source (alternative)

bash
git clone https://github.com/TrialAndErrorAI/appstore-connect-mcp
cd appstore-connect-mcp
npm install
npm run build

Then point your MCP config at `node /path/to/appstore-connect-mcp/dist/index.js` instead of `npx`.

Usage Examples

Discover endpoints

code
search: "Find all endpoints related to customer reviews"

The LLM writes:

javascript
const reviews = Object.entries(spec.paths)
  .filter(([p]) => p.includes('customerReview'))
  .map(([path, methods]) => ({
    path,
    methods: Object.keys(methods).map(m => m.toUpperCase())
  }));
return reviews;

List your apps

code
execute: "List all my apps"

The LLM writes:

javascript
const apps = await api.request({ method: 'GET', path: '/v1/apps' });
return apps.data.map(a => ({ id: a.id, name: a.attributes.name }));

Chain multiple calls

code
execute: "Get latest reviews for my first app"

The LLM writes:

javascript
const apps = await api.request({ method: 'GET', path: '/v1/apps', params: { limit: '1' } });
const appId = apps.data[0].id;
const reviews = await api.request({
  method: 'GET',
  path: `/v1/apps/${appId}/customerReviews`,
  params: { limit: '5', sort: '-createdDate' }
});
return {
  app: apps.data[0].attributes.name,
  reviews: reviews.data.map(r => ({
    rating: r.attributes.rating,
    title: r.attributes.title,
    body: r.attributes.body
  }))
};

What You Can Access

All 923 App Store Connect API endpoints, including:

CategoryEndpointsWhat You Get
App Metadata29Title, subtitle, keywords, description — read AND write
Analytics10Impressions, page views, downloads, source attribution
Sales & Finance2Revenue, units, proceeds by country
Customer Reviews5Ratings, review text, respond to reviews
Subscriptions30Sub management, pricing, groups, offers
In-App Purchases29IAP management, offer codes
Versions28Version management, phased rollout
Screenshots12Upload, reorder, manage screenshot sets
A/B Testing24Product page experiments, treatment variants
Custom Product Pages18Custom landing pages per ad campaign
TestFlight23Beta groups, testers, builds
Pricing11Per-territory pricing, price points
Builds29Build management, processing state

See API-COVERAGE.md for the full grouped map.

How It Works

code
Claude writes JavaScript
    │
    ▼
┌─────────────────────────────────────────────────┐
│ search({ code })                                │
│  Sandbox executes code against OpenAPI spec     │
│  923 paths, 1337 schemas — pre-resolved $refs   │
│  Returns: matching endpoints + parameters       │
└─────────────────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────────────────┐
│ execute({ code })                               │
│  Sandbox executes code against auth'd client    │
│  JWT injected — code never sees credentials     │
│  Supports GET/POST/PATCH/DELETE + chaining      │
│  Auto-decompresses gzipped report responses     │
│  Returns: API response (truncated to 40K chars) │
└─────────────────────────────────────────────────┘

Security

  • Code runs in Node.js `vm` sandbox
  • No `fetch`, `require`, `process`, `eval`, `setTimeout` available
  • Credentials injected via binding — never visible to generated code
  • Response truncated to prevent context bloat
  • Only `spec` (search) or `api` (execute) available as globals

Architecture

code
src/
├── auth/jwt-manager.ts      — JWT with P8 key, ES256, 19-min cache
├── api/client.ts             — HTTP client, rate limiting, gzip handling
├── spec/
│   ├── openapi.json          — Apple's official spec (923 endpoints)
│   └── loader.ts             — Loads + resolves $refs for flat traversal
├── executor/sandbox.ts       — vm-based sandboxed execution
├── server/mcp-server.ts      — MCP server (search, execute, test_connection)
└── index.ts                  — Entry point

Why Code Mode?

Traditional MCPCode Mode
Tools1 per endpoint (923)2 total
Context tokens~100K+~1K
Adding endpointsNew tool + code + schema + releaseApple updates spec. Zero changes.
Chaining callsRe-enter LLM between eachSingle execution, multiple calls
MaintenanceUpdate 923 tool definitionsUpdate 1 spec file

Inspired by Cloudflare's Code Mode pattern.

Development

bash
npm install          # Install dependencies
npm run build        # Compile + copy spec
npm run dev          # Watch mode (tsx)
npm start            # Run compiled server
npm run type-check   # TypeScript check

License

MIT — Use it, modify it, sell it. Just make it work.

Credits

Built by Trial and Error Inc. Used in production by RenovateAI, an AI-powered home design app for iOS, Android, and web. Code mode pattern from Cloudflare.

*"We don't implement individual endpoints. We implement the ability to call ANY endpoint."*

Frequently asked questions

What is appstore-connect-mcp?

appstore-connect-mcp is MCP server for App Store Connect - reliable bridge between iOS metrics and AI assistants

How do I install appstore-connect-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is appstore-connect-mcp open source?

Yes — it is hosted on GitHub at https://github.com/trialanderrorai/appstore-connect-mcp and has 4 stars.

Related MCP tools

CherryHQcherry-studio

🍒 Cherry Studio is a desktop client that supports for multiple LLM providers. Built for the Model Context Protocol to enhance AI capabilities.

35,025 TypeScript
agentanthropicassistant+6
danny-avilalibrechat

Enhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini...

31,284 TypeScript
aianthropicartifacts+17
labringfastgpt

FastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, ...

26,183 TypeScript
agentclaudedeepseek+7
ComposioHQcomposio

Composio equips your AI agents & LLMs with 100+ high-quality integrations via function calling for the Model Context Protocol. Enhance AI assistants with powerf

25,863 TypeScript
agentic-aiagentsai+14
yamadashyrepomix

📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Lan...

19,761 TypeScript
aianthropicartificial-intelligence+17
activepiecesactivepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Ag...

18,776 TypeScript
ai-agentai-agent-toolsai-agents+10

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP