get_segment_criteria
Get full criteria object for a segment by ID or name.
Read audiences
Returns data. Calling it changes nothing, so it is safe in an unattended loop.
What it does
Get full criteria object for a segment by ID or name.
RETURNS: {id, name, status, lastUpdatedDate, criteria}
STATUS VALUES:
- READY: Can use with get_insights_report
- PENDING: Processing (check later)
- FAILED: Error occurred
IMPORTANT: Pass the returned 'criteria' object to get_insights_report, NOT the segment ID.Arguments
| Argument | Type | Notes | |
|---|---|---|---|
segment_id |
integer | Segment ID (fastest lookup). | |
segment_name |
string | Segment name (fuzzy matching, case-insensitive). |
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":"get_segment_criteria","arguments":{}}}'Response
Real, from the production server, in 130 ms. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.
recorded response
nullRelated
Other audiences tools: