App Store Connect MCP Server

Instructions

Implementation Reference

• dist/src/handlers/workflows.js:52-60 (handler)

  The main handler function that fetches detailed information about a specific CI build action from the App Store Connect API endpoint `/ciBuildActions/${buildActionId}`.

  async getBuildAction(args) {
      const { buildActionId, fields, include } = args;
      const params = {};
      if (include?.length) {
          params.include = include.join(',');
      }
      Object.assign(params, buildFieldParams(fields));
      return this.client.get(`/ciBuildActions/${buildActionId}`, params);
  }

• dist/src/index.js:1354-1356 (registration)

  Registers the tool call dispatching to the workflowHandlers.getBuildAction method.

  case "get_ci_build_action":
      const buildActionData = await this.workflowHandlers.getBuildAction(args);
      return formatResponse(buildActionData);

• dist/src/index.js:1010-1044 (schema)

  Defines the tool schema including input parameters (buildActionId required, optional include and fields) for validating tool calls.

  {
      name: "get_ci_build_action",
      description: "Get detailed information about a specific build action",
      inputSchema: {
          type: "object",
          properties: {
              buildActionId: {
                  type: "string",
                  description: "The ID of the build action"
              },
              include: {
                  type: "array",
                  items: {
                      type: "string",
                      enum: ["buildRun", "issues", "testResults"]
                  },
                  description: "Related resources to include in the response"
              },
              fields: {
                  type: "object",
                  properties: {
                      ciBuildActions: {
                          type: "array",
                          items: {
                              type: "string",
                              enum: ["name", "actionType", "startedDate", "finishedDate", "issueCounts", "executionProgress", "completionStatus"]
                          },
                          description: "Fields to include for the build action"
                      }
                  }
              }
          },
          required: ["buildActionId"]
      }
  },

• src/handlers/workflows.ts:123-141 (schema)

  TypeScript type definitions for the getBuildAction handler input parameters and return type.

  async getBuildAction(args: {
    buildActionId: string;
    fields?: {
      ciBuildActions?: CiBuildActionFieldOptions[];
    };
    include?: CiBuildActionIncludeOptions[];
  }): Promise<{ data: any }> {
    const { buildActionId, fields, include } = args;
    
    const params: Record<string, any> = {};
  
    if (include?.length) {
      params.include = include.join(',');
    }
  
    Object.assign(params, buildFieldParams(fields));
  
    return this.client.get<{ data: any }>(`/ciBuildActions/${buildActionId}`, params);
  }

• dist/src/handlers/workflows.js:58-58 (helper)

  Uses helper buildFieldParams to construct API query parameters from fields.

  Object.assign(params, buildFieldParams(fields));