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

Request template, not a complete runnable example. Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

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:

Browse the tool catalog · machine-readable index