marketo_get_smart_lists

Retrieve smart lists from Marketo with configurable pagination controls for efficient data management and segmentation.

Input Schema

TableJSON Schema

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

Implementation Reference

src/index.ts:188-207 (handler)

The handler function that executes the tool logic: constructs query params for pagination, calls makeApiRequest to fetch smart lists from Marketo API endpoint /asset/v1/smartLists.json, returns formatted JSON response or error message.

async ({ maxReturn = 200, offset = 0 }) => {
  try {
    const params = new URLSearchParams({
      maxReturn: maxReturn.toString(),
      offset: offset.toString(),
    });

    const response = await makeApiRequest(`/asset/v1/smartLists.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:184-187 (schema)
Zod input schema defining optional pagination parameters: maxReturn and offset.
```
{
  maxReturn: z.number().optional(),
  offset: z.number().optional(),
},
```

src/index.ts:182-208 (registration)

MCP server.tool registration of the marketo_get_smart_lists tool, including inline schema and handler.

server.tool(
  'marketo_get_smart_lists',
  {
    maxReturn: z.number().optional(),
    offset: z.number().optional(),
  },
  async ({ maxReturn = 200, offset = 0 }) => {
    try {
      const params = new URLSearchParams({
        maxReturn: maxReturn.toString(),
        offset: offset.toString(),
      });

      const response = await makeApiRequest(`/asset/v1/smartLists.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 utility function for making authenticated HTTP requests to Marketo API endpoints using axios, handling token auth and content types.

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