MMetadata /docs
Docs/Tools/get_audience_details

get_audience_details

Custom audience information from Metadata platform: configurations, targeting criteria, size metrics, performance.

Read audiences

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

What it does

Custom audience information from Metadata platform: configurations, targeting criteria, size metrics, performance.

USE FOR: List audiences with pagination/filtering, get specific audience by ID/name, analyze configurations and targeting, review size and performance.

Arguments

ArgumentTypeNotes
page integer Page number for pagination (0-based)
size integer Number of results per page
sort string Sort criteria (e.g., 'creationDate,desc', 'name,asc', 'audienceSize,desc')
name string required Filter by audience name (supports partial matching)

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

Response

No recorded response. This tool needs arguments that only exist inside an account, so no response is recorded here. The request is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.

Other audiences tools:

Browse the tool catalog · machine-readable index