simplifier-mcp

Instructions

Implementation Reference

• src/tools/connector-tools.ts:314-355 (handler)

  The handler function that implements the core logic of the 'connector-call-test' tool. It fetches the connector call's input parameters, matches them with provided test values (or uses constants), retrieves data types, builds a test request, calls the Simplifier client's testConnectorCall method with tracking, and formats the response as success or error with result or error details.

  }, async ({ connectorName, callName, parameters }) => {
    return wrapToolResult(`test connector call ${connectorName}.${callName}`, async () => {
      const connectorParameters =
        (await simplifier.getConnectorCall(connectorName, callName))
          .connectorCallParameters
          .filter(cparam => cparam.isInput)
      const testParameters: ConnectorTestParameter[]  = await Promise.all(connectorParameters.map(async cparam => {
        const dataType = await simplifier.getDataTypeByName(cparam.dataType.name)
        const value = parameters.find(p => p.name === cparam.name)?.value || parameters.find(p => p.name === cparam.alias)?.value || cparam.constValue
        return {
          name: cparam.name,
          constValue: cparam.constValue,
          value: value,
          alias: cparam?.alias,
          dataType: dataType,
          transfer: value !== undefined,
        } satisfies ConnectorTestParameter;
      }))
  
      const testRequest: ConnectorTestRequest = {
        parameters: testParameters
      };
  
      const trackingKey = trackingToolPrefix + toolNameConnectorCallTest
      const result = await simplifier.testConnectorCall(connectorName, callName, testRequest, trackingKey);
  
      // Format the response nicely
      if (result.success) {
        return {
          success: true,
          message: `Connector call '${callName}' executed successfully`,
          result: result.result,
        };
      } else {
        return {
          success: false,
          message: `Connector call '${callName}' execution failed`,
          error: result.error || result.message || "Unknown error",
        };
      }
    });
  });

• src/tools/connector-tools.ts:299-306 (schema)

  Zod input schema defining the parameters for the tool: connectorName (string), callName (string), and optional parameters array each with name (string) and value (unknown JSON).

  inputSchema: {
    connectorName: z.string(),
    callName: z.string(),
    parameters: z.array(z.object({
      name: z.string().describe("Parameter name"),
      value: z.unknown().describe("Parameter value - can be any JSON value")
    })).optional().default([]).describe("Input parameters for the connector call")
  },

• src/tools/connector-tools.ts:295-355 (registration)

  The registration of the 'connector-call-test' tool on the MCP server, including the tool name constant, call to server.registerTool with description, input schema, annotations, and handler function.

  const toolNameConnectorCallTest = "connector-call-test"
  server.registerTool(toolNameConnectorCallTest,
    {
      description: connectorTestDescription,
      inputSchema: {
        connectorName: z.string(),
        callName: z.string(),
        parameters: z.array(z.object({
          name: z.string().describe("Parameter name"),
          value: z.unknown().describe("Parameter value - can be any JSON value")
        })).optional().default([]).describe("Input parameters for the connector call")
      },
      annotations: {
        title: "Test a Connector Call",
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: true,
      },
    }, async ({ connectorName, callName, parameters }) => {
      return wrapToolResult(`test connector call ${connectorName}.${callName}`, async () => {
        const connectorParameters =
          (await simplifier.getConnectorCall(connectorName, callName))
            .connectorCallParameters
            .filter(cparam => cparam.isInput)
        const testParameters: ConnectorTestParameter[]  = await Promise.all(connectorParameters.map(async cparam => {
          const dataType = await simplifier.getDataTypeByName(cparam.dataType.name)
          const value = parameters.find(p => p.name === cparam.name)?.value || parameters.find(p => p.name === cparam.alias)?.value || cparam.constValue
          return {
            name: cparam.name,
            constValue: cparam.constValue,
            value: value,
            alias: cparam?.alias,
            dataType: dataType,
            transfer: value !== undefined,
          } satisfies ConnectorTestParameter;
        }))
  
        const testRequest: ConnectorTestRequest = {
          parameters: testParameters
        };
  
        const trackingKey = trackingToolPrefix + toolNameConnectorCallTest
        const result = await simplifier.testConnectorCall(connectorName, callName, testRequest, trackingKey);
  
        // Format the response nicely
        if (result.success) {
          return {
            success: true,
            message: `Connector call '${callName}' executed successfully`,
            result: result.result,
          };
        } else {
          return {
            success: false,
            message: `Connector call '${callName}' execution failed`,
            error: result.error || result.message || "Unknown error",
          };
        }
      });
    });