---
title: "resolve_audience: Resolve an audience | distribution.tech"
description: "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."
canonical: https://distribution.tech/docs/mcp/tools/resolve-audience
generator: md-live-route
generated: 2026-10-21T10:13:26.309Z
---

# resolve_audience: Resolve an audience | distribution.tech
-   [Getting started](https://distribution.tech/docs)
-   [API reference](https://distribution.tech/docs/api)
-   [MCP and agents](https://distribution.tech/docs/agents)
-   [Changelog](https://distribution.tech/docs/changelog)

Search the docs

Docs

-   Agents ›

    -   [Run a campaign with your agent](https://distribution.tech/docs/agents)
    -   [MCP server](https://distribution.tech/docs/mcp)

-   MCP tools ›

    -   [inventory](https://distribution.tech/docs/mcp/tools/inventory)
    -   [resolve\_audience](https://distribution.tech/docs/mcp/tools/resolve-audience)
    -   [campaign\_status](https://distribution.tech/docs/mcp/tools/campaign-status)
    -   [evidence](https://distribution.tech/docs/mcp/tools/evidence)
    -   [results](https://distribution.tech/docs/mcp/tools/results)
    -   [brain\_get](https://distribution.tech/docs/mcp/tools/brain-get)
    -   [creators\_search](https://distribution.tech/docs/mcp/tools/creators-search)
    -   [creator\_get](https://distribution.tech/docs/mcp/tools/creator-get)
    -   [creator\_ask\_price](https://distribution.tech/docs/mcp/tools/creator-ask-price)
    -   [plan\_quote](https://distribution.tech/docs/mcp/tools/plan-quote)
    -   [create\_campaign](https://distribution.tech/docs/mcp/tools/create-campaign)
    -   [plan\_add\_creator](https://distribution.tech/docs/mcp/tools/plan-add-creator)
    -   [plan\_remove\_creator](https://distribution.tech/docs/mcp/tools/plan-remove-creator)
    -   [plan\_move\_dates](https://distribution.tech/docs/mcp/tools/plan-move-dates)
    -   [plan\_swap\_creator](https://distribution.tech/docs/mcp/tools/plan-swap-creator)
    -   [set\_creator\_guidelines](https://distribution.tech/docs/mcp/tools/set-creator-guidelines)
    -   [approve\_plan](https://distribution.tech/docs/mcp/tools/approve-plan)
    -   [archive\_campaign](https://distribution.tech/docs/mcp/tools/archive-campaign)
    -   [rename\_campaign](https://distribution.tech/docs/mcp/tools/rename-campaign)
    -   [delete\_campaign](https://distribution.tech/docs/mcp/tools/delete-campaign)
    -   [feedback\_send](https://distribution.tech/docs/mcp/tools/feedback-send)
    -   [feedback\_list](https://distribution.tech/docs/mcp/tools/feedback-list)


1.  [distribution](https://distribution.tech/)
2.  / [Docs](https://distribution.tech/docs)
3.  / [MCP tools](https://distribution.tech/docs#mcp)
4.  / resolve\_audience

MCP tool

# Resolve an audience

resolve\_audience

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.

Copy page as markdown [View .md](https://distribution.tech/docs/mcp/tools/resolve-audience.md)

## 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](https://distribution.tech/docs/api/get-audience)

## Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `intent_id` | string (uuid) | No | One of your campaigns. Leave out to describe a profile instead. |
| `product` | string | No | What is being promoted. |
| `audience` | string | No | Who it is for, in your words. |
| `geography` | string | No | Where the audience is, or worldwide. |

## 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

```
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:

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `version` | 1 | Yes |  |
| `computed_at` | string (date-time) | Yes |  |
| `coverage_as_of` | string (date-time) or null | Yes |  |
| `segments` | array of object | Yes |  |
| `regions` | array of string | Yes |  |
| `unresolved` | boolean | Yes |  |
| `channels` | array of object | Yes |  |
| `thin` | boolean | Yes |  |
| `summary` | string | Yes |  |

structuredContent, every field with its type

```
{
  "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,
      "bookable_nodes": 0,
      "priced_units": 0,
      "note": "<string>"
    }
  ],
  "thin": false,
  "summary": "<string>"
}
```

## Other tools

-   [`inventory`](https://distribution.tech/docs/mcp/tools/inventory): Network coverage
-   [`campaign_status`](https://distribution.tech/docs/mcp/tools/campaign-status): Campaign status
-   [`evidence`](https://distribution.tech/docs/mcp/tools/evidence): Proof of delivery
-   [`results`](https://distribution.tech/docs/mcp/tools/results): Results
-   [`brain_get`](https://distribution.tech/docs/mcp/tools/brain-get): Company context
-   [`creators_search`](https://distribution.tech/docs/mcp/tools/creators-search): Find creators
-   [`creator_get`](https://distribution.tech/docs/mcp/tools/creator-get): One creator
-   [`creator_ask_price`](https://distribution.tech/docs/mcp/tools/creator-ask-price): Ask for a price
-   [`plan_quote`](https://distribution.tech/docs/mcp/tools/plan-quote): Quote a plan
-   [`create_campaign`](https://distribution.tech/docs/mcp/tools/create-campaign): Start a campaign
-   [`plan_add_creator`](https://distribution.tech/docs/mcp/tools/plan-add-creator): Add a creator
-   [`plan_remove_creator`](https://distribution.tech/docs/mcp/tools/plan-remove-creator): Remove a creator
-   [`plan_move_dates`](https://distribution.tech/docs/mcp/tools/plan-move-dates): Move a plan's dates
-   [`plan_swap_creator`](https://distribution.tech/docs/mcp/tools/plan-swap-creator): Swap a creator
-   [`set_creator_guidelines`](https://distribution.tech/docs/mcp/tools/set-creator-guidelines): Set the creator guidelines
-   [`approve_plan`](https://distribution.tech/docs/mcp/tools/approve-plan): Approve and get the pay link
-   [`archive_campaign`](https://distribution.tech/docs/mcp/tools/archive-campaign): Archive a campaign
-   [`rename_campaign`](https://distribution.tech/docs/mcp/tools/rename-campaign): Rename a campaign
-   [`delete_campaign`](https://distribution.tech/docs/mcp/tools/delete-campaign): Delete a draft campaign
-   [`feedback_send`](https://distribution.tech/docs/mcp/tools/feedback-send): Send feedback
-   [`feedback_list`](https://distribution.tech/docs/mcp/tools/feedback-list): Your feedback

## Get access

Keys are created in Developers once your brand is approved. [Connect an agent](https://distribution.tech/distribution#access) to ask for access, then read [the agent guide](https://distribution.tech/docs/agents) for the full flow.

On this page

-   [Overview](#overview)
-   [Arguments](#arguments)
-   [Call with curl](#curl)
-   [Result](#result)
-   [Other tools](#related)
-   [Get access](#access)

[![distribution.tech](https://distribution.tech/brand/wordmark-light.svg)![distribution.tech](https://distribution.tech/brand/wordmark.svg)](https://distribution.tech/)

Your agent buys your distribution.

Distribution we run for

-   ClickUp
-   Gushwork
-   Tab

Platform

-   [How it works](https://distribution.tech/how-it-works)
-   [Network](https://distribution.tech/network)
-   [Workspace](https://app.distribution.tech/login)
-   [For your agents](https://distribution.tech/distribution)

Solutions

-   [Product launch](https://distribution.tech/solutions/product-launch)
-   [Funding announcement](https://distribution.tech/solutions/funding-announcement)
-   [Feature release](https://distribution.tech/solutions/feature-release)
-   [For brands](https://distribution.tech/for-brands)
-   [For creators](https://distribution.tech/for-creators)

Resources

-   [Blog](https://distribution.tech/blog)
-   [Launch playbook](https://distribution.tech/playbook)
-   [X creator rates](https://distribution.tech/rates/x-creators)

Company

-   [Customers](https://distribution.tech/customers)
-   [Pricing](https://distribution.tech/pricing)
-   [Changelog](https://distribution.tech/changelog)
-   [Build a distribution plan](https://app.distribution.tech/login)
-   [Join the creator network](https://distribution.tech/for-creators#apply)
-   [Log in](https://app.distribution.tech/login)

Legal

-   [Privacy](https://distribution.tech/privacy)
-   [Terms](https://distribution.tech/terms)

© 2026 distribution.tech [Contact: team@distribution.tech](mailto:team@distribution.tech)Cookie settings

Light Dark System