marketo_get_forms

Retrieve Marketo forms with filtering options for status and pagination control to manage form workflows.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`maxReturn`	No
`offset`	No
`status`	No

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;
  }
}

Marketo MCP Server