`klaviyo_list_lists`

Pack: klaviyo · Endpoint: https://gateway.pipeworx.io/klaviyo/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/klaviyo_list_lists for the schema, then POST the same URL with its arguments for the data.

Get all email lists in your account. Returns list IDs, names, subscriber counts, and creation dates.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Klaviyo private API key

Example call

Arguments

{
  "_apiKey": "your-klaviyo-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/klaviyo/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"klaviyo_list_lists","arguments":{"_apiKey":"your-klaviyo-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('klaviyo_list_lists', {
  "_apiKey": "your-klaviyo-api-key"
});

Response shape

Field	Type	Description
`data`	array	Array of list objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "description": "Array of list objects",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Resource type (list)"
          },
          "id": {
            "type": "string",
            "description": "List ID"
          },
          "attributes": {
            "type": "object",
            "description": "List attributes",
            "properties": {
              "name": {
                "type": "string",
                "description": "List name"
              },
              "created_at": {
                "type": "string",
                "description": "Creation timestamp"
              },
              "updated_at": {
                "type": "string",
                "description": "Last update timestamp"
              },
              "profile_count": {
                "type": "number",
                "description": "Number of subscribers"
              }
            }
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "klaviyo": {
      "url": "https://gateway.pipeworx.io/klaviyo/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

klaviyo_list_lists