MMetadata /docs
⌘K
Docs/Tools/list_target_groups

list_target_groups

List and search target groups in Metadata platform.

Read audiences

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

What it does

List and search target groups in Metadata platform.

USE FOR: "list all target groups", "show available target groups", "search target groups with name X", "find target groups containing 'engineer'", "get target group IDs by name", "what target groups do I have?"

WORKFLOW: list_target_groups(name="X") → get ID → retrieve_target_group_by_id(target_group_id=ID) for full details.

RESPONSE: Paginated {content: [{id, name, channel, audienceSize, createdDate, modifiedDate, status}], totalElements, totalPages}

SEARCH: Partial matching, case-insensitive. name="engineer" matches "Engineers EMEA", "Senior Engineers", etc.

Arguments

ArgumentTypeNotes
name string Optional name filter for searching target groups (partial matching, case-insensitive). Example: 'engineer' matches 'Engineers EMEA', 'Senior Engineers', etc.
sort string Sort criteria. Options: 'createdDate,desc' (newest first), 'createdDate,asc' (oldest first), 'name,asc' (A-Z), 'name,desc' (Z-A). Default: 'createdDate,desc'

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_target_groups","arguments":{}}}'

Response

Real, from the production server, in 299 ms. The full response was 5,729 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
{
 "totalElements": 45,
 "totalPages": 5,
 "data": [
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "REDDIT",
   "createdDate": "2026-09-03T22:16:30.000Z",
   "matchCountType": "FIXED_SIZE",
   "matchCount": "[number redacted]",
   "isMatchCountTooSmall": false,
   "visibility": "VISIBLE",
   "mdAudienceIds": [],
   "tags": [],
   "activeExperiments": false,
   "locked": false,
   "inactiveAudiences": false,
   "hasExclusionCriteria": true,
   "hasAudiencesOlderThan90Days": false,
   "hasAudiencesOlderThan180Days": false
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "REDDIT",
   "createdDate": "2026-09-03T20:45:30.000Z",
   "matchCountType": "FIXED_SIZE",
   "matchCount": "[number redacted]",
   "isMatchCountTooSmall": false,
   "visibility": "VISIBLE",
   "mdAudienceIds": [],
   "tags": [],
   "activeExperiments": false,
   "locked": false,
   "inactiveAudiences": false,
   "hasExclusionCriteria": false,
   "hasAudiencesOlderThan90Days": false,
   "hasAudiencesOlderThan180Days": false
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "REDDIT",
   "createdDate": "2026-08-28T18:47:50.000Z",
   "matchCountType": "FIXED_SIZE",
   "matchCount": "[number redacted]",
   "isMatchCountTooSmall": false,
   "visibility": "VISIBLE",
   "mdAudienceIds": [],
   "tags": [],
   "activeExperiments": false,
   "locked": false,
   "inactiveAudiences": false,
   "hasExclusionCriteria": true,
   "hasAudiencesOlderThan90Days": false,
   "hasAudiencesOlderThan180Days": false
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "REDDIT",
   "createdDate": "2026-08-28T15:26:07.000Z",
   "matchCountType": "FIXED_SIZE",
   "matchCount": "[number redacted]",
   "isMatchCountTooSmall": false,
   "visibility": "VISIBLE",
   "mdAudienceIds": [],
   "tags": [],
   "activeExperiments": false,
   "locked": false,
   "inactiveAudiences": false,
   "hasExclusionCriteria": false,
   "hasAudiencesOlderThan90Days": false,
   "hasAudiencesOlderThan180Days": false
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "REDDIT",
   "createdDate": "2026-08-27T17:35:55.000Z",
   "matchCountType": "FIXED_SIZE",
   "matchCount": "[number redacted]",
   "isMatchCountTooSmall": false,
   "visibility": "VISIBLE",
   "mdAudienceIds": [],
   "tags": [],
   "activeExperiments": false,
   "locked": false,
   "inactiveAudiences": false,
   "hasExclusionCriteria": false,
   "hasAudiencesOlderThan90Days": false,
   "hasAudiencesOlderThan180Days": false
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "FACEBOOK",
   "createdDate": "2026-08-25T11:02:01.000Z",
   "matchCountType": "FIXED_SIZE",
   "matchCount": "[number redacted]",
   "isMatchCountTooSmall": false,
   "visibility": "VISIBLE",
   "mdAudienceIds": [],
   "tags": [],
   "activeExperiments": false,
   "locked": false,
   "inactiveAudiences": false,
   "hasExclusionCriteria": false,
   "hasAudiencesOlderThan90Days": false,
   "hasAudiencesOlderThan180Days": false
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "LINKEDIN",
   "createdDate": "2026-08-25T11:01:00.000Z",
   "matchCountType": "FIXED_SIZE",
   "matchCount": "[number redacted]",
   "isMatchCountTooSmall": false,
   "visibility": "VISIBLE",
   "mdAudienceIds": [
    "[number redacted]"
   ],
   "tags": [],
   "activeExperiments": false,
   "locked": false,
   "inactiveAudiences": false,
   "hasExclusionCriteria": true,
   "hasAudiencesOlderThan90Days": false,
   "hasAudiencesOlderThan180Days": false
  },
  {
   "id": "[number redacted]",
   "name": "[name redacted]",
   "channel": "REDDIT",
   "createdDate": "2026-08-24T13:23:38.000Z",
   "matchCountType": "FIXED_SIZE",
   "matchCount": "[number redacted]",
   "isMatchCountTooSmall": false,
   "visibility": "VISIBLE",
   "mdAudienceIds": [],
   "tags": [],
   "activeExperiments": false,
  
  … truncated

Other audiences tools:

All 160 tools · machine-readable index