Authorize.net MCP Server

Instructions

Implementation Reference

• src/index.ts:54-76 (handler)

  The main handler function that executes the Authorize.Net API call to retrieve the list of settled batches within the specified date range using GetSettledBatchListController.

  async function getSettledBatchList(firstSettlementDate?: string, lastSettlementDate?: string) {
    const request = new ApiContracts.GetSettledBatchListRequest();
    request.setMerchantAuthentication(getMerchantAuth());
    request.setIncludeStatistics(true);
  
    if (firstSettlementDate) {
      request.setFirstSettlementDate(new Date(firstSettlementDate));
    }
    if (lastSettlementDate) {
      request.setLastSettlementDate(new Date(lastSettlementDate));
    }
  
    const ctrl = new ApiControllers.GetSettledBatchListController(request.getJSON());
    const response = await executeController(ctrl);
  
    const apiResponse = new ApiContracts.GetSettledBatchListResponse(response);
    if (apiResponse.getMessages().getResultCode() !== ApiContracts.MessageTypeEnum.OK) {
      const errors = apiResponse.getMessages().getMessage();
      throw new Error(`API Error: ${errors[0].getCode()} - ${errors[0].getText()}`);
    }
  
    return apiResponse.getBatchList() || [];
  }

• src/index.ts:200-216 (registration)

  Registration of the tool in the MCP server's ListToolsRequestSchema handler, including name, description, and input schema definition.

  {
    name: "get_settled_batch_list",
    description: "Get a list of settled batches within a date range. Returns batch IDs, settlement dates, and statistics.",
    inputSchema: {
      type: "object",
      properties: {
        firstSettlementDate: {
          type: "string",
          description: "Start date for the batch list (ISO 8601 format, e.g., 2024-01-01). Defaults to 30 days ago.",
        },
        lastSettlementDate: {
          type: "string",
          description: "End date for the batch list (ISO 8601 format). Defaults to today.",
        },
      },
    },
  },

• src/index.ts:301-306 (registration)

  Dispatch to the getSettledBatchList handler within the MCP server's CallToolRequestSchema handler.

  case "get_settled_batch_list":
    result = await getSettledBatchList(
      args?.firstSettlementDate as string | undefined,
      args?.lastSettlementDate as string | undefined
    );
    break;

• src/index.ts:203-215 (schema)

  Input schema definition for the get_settled_batch_list tool.

  inputSchema: {
    type: "object",
    properties: {
      firstSettlementDate: {
        type: "string",
        description: "Start date for the batch list (ISO 8601 format, e.g., 2024-01-01). Defaults to 30 days ago.",
      },
      lastSettlementDate: {
        type: "string",
        description: "End date for the batch list (ISO 8601 format). Defaults to today.",
      },
    },
  },

• src/index.ts:37-51 (helper)

  Helper function used by the handler to execute Authorize.Net API controllers asynchronously.

  function executeController(ctrl: any): Promise<any> {
    return new Promise((resolve, reject) => {
      if (ENVIRONMENT === "production") {
        ctrl.setEnvironment(SDKConstants.endpoint.production);
      }
      ctrl.execute(() => {
        const response = ctrl.getResponse();
        if (response === null) {
          reject(new Error(ctrl.getErrorResponse() || "No response from API"));
        } else {
          resolve(response);
        }
      });
    });
  }