Resolve an audience

Overview

The audience fit for one of your campaigns (intent_id) or for a profile you describe (product, audience, geography): the audience segments it matches and the coverage per channel. The same check a campaign gets when it starts.

Server

https://app.distribution.tech/api/mcp

Scope

audience:read

Changes data

No, a read

REST endpoint

GET /audience

Arguments

Call with curl

The server speaks streamable HTTP, so one JSON-RPC tools/call request runs the tool. Set DISTRIBUTION_API_KEY to a key from Developers with the audience:read scope; the arguments shown are the required ones.

curl -X POST "https://app.distribution.tech/api/mcp" \
  -H "Authorization: Bearer $DISTRIBUTION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "resolve_audience",
    "arguments": {}
  }
}'

Result

The answer's structuredContent follows the tool's output schema (the same JSON is in its text content). It has these fields:

{
  "version": 1,
  "computed_at": "<date-time>",
  "coverage_as_of": "<date-time>",
  "segments": [
    {
      "id": "<string>",
      "label": "<string>"
    }
  ],
  "regions": [
    "<string>"
  ],
  "unresolved": false,
  "channels": [
    {
      "channel": "x_creators",
      "label": "<string>",
      "sale": "live",
      "level": "strong",
      "verified_nodes": 0,
      "priced_units": 0,
      "note": "<string>"
    }
  ],
  "thin": false,
  "summary": "<string>"
}

Other tools

• inventory: Network coverage
• campaign_status: Campaign status
• evidence: Proof of delivery
• results: Results
• brain_get: Company context
• creators_search: Find creators
• creator_get: One creator
• creator_ask_price: Ask for a price
• plan_quote: Quote a plan
• create_campaign: Start a campaign
• plan_add_creator: Add a creator
• plan_remove_creator: Remove a creator
• plan_move_dates: Move a plan's dates
• plan_swap_creator: Swap a creator
• set_creator_guidelines: Set the creator guidelines
• approve_plan: Approve and get the pay link
• archive_campaign: Archive a campaign
• rename_campaign: Rename a campaign
• delete_campaign: Delete a draft campaign
• feedback_send: Send feedback
• feedback_list: Your feedback

Get access

Keys are created in Developers once your brand is approved. Connect an agent to ask for access, then read the agent guide for the full flow.