marketo_get_forms

Implementation Reference

• src/index.ts:63-86 (handler)

  The handler function for the 'marketo_get_forms' tool. It constructs query parameters for maxReturn, offset, and optional status filter, makes an authenticated GET request to the Marketo Forms API endpoint, and returns the JSON response or error message.

  async ({ maxReturn = 200, offset = 0, status }) => {
    try {
      const params = new URLSearchParams({
        maxReturn: maxReturn.toString(),
        offset: offset.toString(),
      });
  
      if (status) {
        params.append('status', status);
      }
  
      const response = await makeApiRequest(`/asset/v1/forms.json?${params.toString()}`, 'GET');
  
      return {
        content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
      };
    } catch (error: any) {
      return {
        content: [
          { type: 'text', text: `Error: ${error.response?.data?.message || error.message}` },
        ],
      };
    }
  }

• src/index.ts:58-62 (schema)

  Zod input schema defining optional parameters: maxReturn (number), offset (number), status (enum: 'approved' or 'draft').

  {
    maxReturn: z.number().optional(),
    offset: z.number().optional(),
    status: z.enum(['approved', 'draft']).optional(),
  },

• src/index.ts:56-87 (registration)

  Registration of the 'marketo_get_forms' tool on the MCP server using server.tool(), including schema and inline handler function.

  server.tool(
    'marketo_get_forms',
    {
      maxReturn: z.number().optional(),
      offset: z.number().optional(),
      status: z.enum(['approved', 'draft']).optional(),
    },
    async ({ maxReturn = 200, offset = 0, status }) => {
      try {
        const params = new URLSearchParams({
          maxReturn: maxReturn.toString(),
          offset: offset.toString(),
        });
  
        if (status) {
          params.append('status', status);
        }
  
        const response = await makeApiRequest(`/asset/v1/forms.json?${params.toString()}`, 'GET');
  
        return {
          content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
        };
      } catch (error: any) {
        return {
          content: [
            { type: 'text', text: `Error: ${error.response?.data?.message || error.message}` },
          ],
        };
      }
    }
  );

• src/index.ts:22-52 (helper)

  Shared helper function used by the tool to perform authenticated HTTP requests to the Marketo API using axios, handling token retrieval and error logging.

  async function makeApiRequest(
    endpoint: string,
    method: string,
    data?: any,
    contentType: string = 'application/json'
  ) {
    const token = await tokenManager.getToken();
    const headers: any = {
      Authorization: `Bearer ${token}`,
    };
  
    if (contentType) {
      headers['Content-Type'] = contentType;
    }
  
    try {
      const response = await axios({
        url: `${MARKETO_BASE_URL}${endpoint}`,
        method: method,
        data:
          contentType === 'application/x-www-form-urlencoded'
            ? new URLSearchParams(data).toString()
            : data,
        headers,
      });
      return response.data;
    } catch (error: any) {
      console.error('API request failed:', error.response?.data || error.message);
      throw error;
    }
  }