MMetadata /docs
⌘K
Docs/Tools/list_marketing_automation_lists

list_marketing_automation_lists

List a Marketing-Automation provider's contact library lists — the selectable source for creating a Marketing-Automation-contacts audience.

Read audiences

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

List a Marketing-Automation provider's contact library lists — the selectable source for creating a Marketing-Automation-contacts audience.

                PREREQUISITE:
                  • The provider MUST be connected. Only HUBSPOT and MARKETO expose library lists.

                WHEN TO USE:
                  • Before create_marketing_automation_contacts_audience, to find the library_list_id.
                  • "list my HubSpot lists", "which Marketo lists can I use for an audience".

                PARAMETERS:
                  • provider (required): HUBSPOT or MARKETO.
                  • list_type (optional): SMART_LIST | STATIC_LIST | ACTIVE_LIST. If omitted, the provider's own list types are queried and merged (HubSpot: STATIC_LIST + ACTIVE_LIST; Marketo: all three).
                  • name (optional): filter by list name (partial).

                RETURNS: { lists: [ { library_list_id, name, status, listType, objectsCount } ] }. Use `library_list_id` for create. For HubSpot a list is usable only when status is DONE; for Marketo when READY.

Arguments

ArgumentTypeNotes
provider string required The Marketing-Automation provider to list lists for.
one of: HUBSPOT, MARKETO
list_type string Optional list-type filter. If omitted, the provider's own list types are queried and merged (HubSpot: STATIC_LIST + ACTIVE_LIST; Marketo: all three).
one of: SMART_LIST, STATIC_LIST, ACTIVE_LIST
name string Optional list-name filter (partial match).

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_marketing_automation_lists","arguments":{"provider":"HUBSPOT"}}}'

Response

Recorded with these arguments. Enum values are the first the tool's own schema declares; ids were fetched live from a list_ call immediately before.

arguments used
{
 "provider": "HUBSPOT"
}

Real, from the production server, in 524 ms. The full response was 32,266 bytes; this is the first part of it. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
{
 "lists": [
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "first_name_enrichmnet",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 1
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 11
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 7
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 1
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 3
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 4
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 1
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 71
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 22
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 22
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 6
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": 12
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[name redacted]",
   "status": "DONE",
   "listType": "STATIC_LIST",
   "objectsCount": "[number redacted]"
  },
  {
   "library_list_id": "[number redacted]",
   "name": "[nam
  … truncated

Other audiences tools:

All 160 tools · machine-readable index