Make MCP Server

Instructions

Implementation Reference

• src/index.ts:59-87 (handler)

  Dynamic handler for all run_scenario_* tools (including run_scenario_2361). Extracts scenario ID from tool name, executes the scenario via make.scenarios.run, and returns JSON output or error message.

  server.setRequestHandler(CallToolRequestSchema, async request => {
      if (/^run_scenario_\d+$/.test(request.params.name)) {
          try {
              const output = (
                  await make.scenarios.run(parseInt(request.params.name.substring(13)), request.params.arguments)
              ).outputs;
  
              return {
                  content: [
                      {
                          type: 'text',
                          text: output ? JSON.stringify(output, null, 2) : 'Scenario executed successfully.',
                      },
                  ],
              };
          } catch (err: unknown) {
              return {
                  isError: true,
                  content: [
                      {
                          type: 'text',
                          text: String(err),
                      },
                  ],
              };
          }
      }
      throw new Error(`Unknown tool: ${request.params.name}`);
  });

• src/index.ts:37-57 (registration)

  Dynamic tool registration: lists on-demand scenarios from Make API, generates a tool named run_scenario_${scenario.id} (e.g., run_scenario_2361 for ID 2361) with description and inputSchema.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
      const scenarios = await make.scenarios.list(teamId);
      return {
          tools: await Promise.all(
              scenarios
                  .filter(scenario => scenario.scheduling.type === 'on-demand')
                  .map(async scenario => {
                      const inputs = (await make.scenarios.interface(scenario.id)).input;
                      return {
                          name: `run_scenario_${scenario.id}`,
                          description: scenario.name + (scenario.description ? ` (${scenario.description})` : ''),
                          inputSchema: remap({
                              name: 'wrapper',
                              type: 'collection',
                              spec: inputs,
                          }),
                      };
                  }),
          ),
      };
  });

• src/make.ts:33-42 (helper)

  Core execution logic: POSTs to Make API /scenarios/${scenarioId}/run endpoint with input arguments to run the scenario.

      async run(scenarioId: number, body: unknown): Promise<ScenarioRunServerResponse> {
          return await this.#fetch<ScenarioRunServerResponse>(`/scenarios/${scenarioId}/run`, {
              method: 'POST',
              body: JSON.stringify({ data: body, responsive: true }),
              headers: {
                  'content-type': 'application/json',
              },
          });
      }
  }

• src/utils.ts:60-108 (schema)

  Converts Make scenario input specification (nested objects, arrays, selects, primitives) to JSON Schema object for the tool's inputSchema.

  export function remap(field: Input): unknown {
      switch (field.type) {
          case 'collection':
              const required: string[] = [];
              const properties: unknown = (Array.isArray(field.spec) ? field.spec : []).reduce((object, subField) => {
                  if (!subField.name) return object;
                  if (subField.required) required.push(subField.name);
  
                  return Object.defineProperty(object, subField.name, {
                      enumerable: true,
                      value: remap(subField),
                  });
              }, {});
  
              return {
                  type: 'object',
                  description: noEmpty(field.help),
                  properties,
                  required,
              };
          case 'array':
              return {
                  type: 'array',
                  description: noEmpty(field.help),
                  items:
                      field.spec &&
                      remap(
                          Array.isArray(field.spec)
                              ? {
                                    type: 'collection',
                                    spec: field.spec,
                                }
                              : field.spec,
                      ),
              };
          case 'select':
              return {
                  type: 'string',
                  description: noEmpty(field.help),
                  enum: (field.options || []).map(option => option.value),
              };
          default:
              return {
                  type: PRIMITIVE_TYPE_MAP[field.type as keyof typeof PRIMITIVE_TYPE_MAP],
                  default: field.default != '' && field.default != null ? field.default : undefined,
                  description: noEmpty(field.help),
              };
      }
  }