App Store Connect MCP Server

Instructions

Implementation Reference

• src/handlers/apps.ts:25-39 (handler)

  The core handler function that executes the get_app_info tool logic by calling the AppStoreConnectClient to fetch detailed information about a specific app using its ID, optionally including related resources.

  async getAppInfo(args: { 
    appId: string; 
    include?: AppIncludeOptions[];
  }): Promise<AppInfoResponse> {
    const { appId, include } = args;
    
    validateRequired(args, ['appId']);
  
    const params: Record<string, any> = {};
    if (include?.length) {
      params.include = include.join(',');
    }
  
    return this.client.get<AppInfoResponse>(`/apps/${appId}`, params);
  }

• src/index.ts:106-131 (schema)

  Defines the JSON schema for the input parameters of the get_app_info tool, advertised to MCP clients via the ListTools response. Specifies appId as required and include as optional array of relationships.

    name: "get_app_info",
    description: "Get detailed information about a specific app",
    inputSchema: {
      type: "object", 
      properties: {
        appId: {
          type: "string",
          description: "The ID of the app to get information for"
        },
        include: {
          type: "array",
          items: {
            type: "string",
            enum: [
              "appClips", "appInfos", "appStoreVersions", "availableTerritories",
              "betaAppReviewDetail", "betaGroups", "betaLicenseAgreement", "builds",
              "endUserLicenseAgreement", "gameCenterEnabledVersions", "inAppPurchases",
              "preOrder", "prices", "reviewSubmissions"
            ]
          },
          description: "Optional relationships to include in the response"
        }
      },
      required: ["appId"]
    }
  },

• src/index.ts:1318-1320 (registration)

  Registers the tool name 'get_app_info' in the MCP CallTool request handler switch statement, dispatching calls to the appHandlers.getAppInfo method and formatting the response.

  const appInfo = await this.appHandlers.getAppInfo(args as any);
  return formatResponse(appInfo);