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. A NAME IS REQUIRED: this is the by-name lookup, not the account-wide browse. USE FOR: resolve an audience the user named (partial match, paged, sortable), read its configuration and targeting, review its size and performance.
Arguments
| Argument | Type | Notes | |
|---|---|---|---|
page |
integer | Page number for pagination (0-based) | |
size |
integer | Number of results per page | |
sort |
string | Sort as '<field>,<asc|desc>' over the audience record's own fields: creationDate (default), updateDate, name, status, type, expectedNumberOfContacts, expectedNumberOfCompanies, id. For the largest audiences sort by 'expectedNumberOfContacts,desc' (people) or 'expectedNumberOfCompanies,desc' (account | |
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.
Related
Other audiences tools: