Show JSON
{
"protocolVersion": "1.0",
"name": "Infinite Audience",
"description": "Enrich customer data, discover high-fidelity net-new audiences, and activate them in your channels through an AI agent. Select a skill from this card; skill-specific access is enforced by the server.",
"author": "NO FAIT (dba Infinite Audience)",
"wellKnownURI": "https://a2a.infiniteaudience.ai/.well-known/agent-card.json",
"url": "https://a2a.infiniteaudience.ai/a2a",
"version": "1.6.1",
"provider": {
"organization": "NO FAIT (dba Infinite Audience)",
"url": "https://infiniteaudience.ai/"
},
"documentationUrl": "https://docs.infiniteaudience.ai/agents/a2a/",
"iconUrl": null,
"supportsAuthenticatedExtendedCard": false,
"security": [
{
"schemes": {
"infiniteAudienceOAuth": {}
}
},
{
"schemes": {
"infiniteAudienceDeviceOAuth": {}
}
},
{
"schemes": {
"infiniteAudienceBearer": {}
}
}
],
"securitySchemes": {
"infiniteAudienceOAuth": {
"oauth2SecurityScheme": {
"flows": {
"authorizationCode": {
"scopes": {
"creator": "Authorize create and export access: create, match, and deliver data using organization subscription capacity.",
"discovery": "Catalog, counts, and history; may perform backend computation.",
"account-read": "Read organization subscription capacity, utilization, readiness and existing replenishment request status."
},
"tokenUrl": "https://api.infiniteaudience.ai/v1/oauth/token",
"refreshUrl": "https://api.infiniteaudience.ai/v1/oauth/token",
"pkceRequired": true,
"authorizationUrl": "https://api.infiniteaudience.ai/v1/oauth/authorize"
}
},
"description": "Delegated user access using authorization code and PKCE.",
"oauth2MetadataUrl": "https://api.infiniteaudience.ai/.well-known/oauth-authorization-server"
}
},
"infiniteAudienceBearer": {
"httpAuthSecurityScheme": {
"scheme": "Bearer",
"description": "Short-lived token from server-to-server API-key exchange.",
"bearerFormat": "JWT"
}
},
"infiniteAudienceDeviceOAuth": {
"oauth2SecurityScheme": {
"flows": {
"deviceCode": {
"scopes": {
"creator": "Authorize create and export access: create, match, and deliver data using organization subscription capacity.",
"discovery": "Catalog, counts, and history; may perform backend computation.",
"account-read": "Read organization subscription capacity, utilization, readiness and existing replenishment request status."
},
"tokenUrl": "https://api.infiniteaudience.ai/v1/oauth/token",
"deviceAuthorizationUrl": "https://api.infiniteaudience.ai/v1/oauth/device_authorization"
}
},
"description": "Delegated access for chat and terminal clients using device authorization.",
"oauth2MetadataUrl": "https://api.infiniteaudience.ai/.well-known/oauth-authorization-server"
}
}
},
"capabilities": {
"streaming": true,
"pushNotifications": false,
"stateTransitionHistory": false,
"extensions": null
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
],
"skills": [
{
"id": "discovery-count",
"name": "Discovery Count",
"description": "Count matching records in the audience graph given geo, demographic, behavioral, or custom filter criteria. Accepts saved segment IDs, audience IDs, multi-segment composition, filter_groups, or flat filters. Returns total record count without purchasing records; backend compute usage is recorded as non-commercial telemetry. Requires 'discovery' scope.",
"tags": [
"audiences",
"discovery",
"counts"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "discovery-lookup",
"name": "Discovery Lookup",
"description": "Return masked sample rows and field metadata for a defined audience without purchasing records. Accepts saved segment IDs, audience IDs, multi-segment composition, filter_groups, or flat filters. Useful for validating filter criteria before committing to a delivery; backend compute usage is non-commercial telemetry. Requires 'discovery' scope.",
"tags": [
"audiences",
"discovery",
"samples"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "discovery-crosstab",
"name": "Discovery Crosstab",
"description": "Cross-tabulate a population by two categorical dimensions (e.g. state x gender) and return a pivot table of counts. Accepts saved segment IDs, audience IDs, multi-segment composition, filter_groups, or flat filters. Backend compute usage is non-commercial telemetry. Requires 'discovery' scope.",
"tags": [
"audiences",
"discovery",
"analysis"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "discovery-overlap",
"name": "Discovery Overlap",
"description": "Calculate how many records appear in both of two populations (audiences, segments, or ad-hoc filter sets) and return overlap count, overlap_pct, and demographic deltas. Backend compute usage is non-commercial telemetry. Requires 'discovery' scope.",
"tags": [
"audiences",
"discovery",
"overlap"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "audience-management",
"name": "Audience Management",
"description": "Create and manage audiences: composition wrappers that group one or more segments for delivery. Audiences have no subtype — use segment-management to create typed cohorts. Duplicate an existing audience via the duplicate_audience tool — the duplicate carries the source composition with lineage tracking (parent and root ancestor recorded, segment versions pinned) and starts with a null record count until recounted. Refresh a stale or expired audience via the refresh_audience tool — since an audience is a composition of one or more member segments (possibly mixed subtypes) with no single 'primary' segment, refresh_audience requires a segment_id naming which member to refresh; choose a filter or matched member because custom snapshots require a new internal publication; it refreshes that eligible segment and bumps the audience's own version/expiry, but never any other audience referencing the same segment. Operate on one audience per action. Archival is reversible via archive_audience with restore=true; external agents do not delete audiences. Requires 'creator' scope.",
"tags": [
"audiences",
"composition",
"management"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "segment-management",
"name": "Segment Management",
"description": "Create filter (criteria-based) or matched (uploaded CSV/JSON/JSONL/Avro lists, optionally gzip-compressed and split into same-format shards) segments. Runtime subtypes are filter, matched and custom; custom membership is published through the internal data-team tool. Automated custom generation is not yet available. Matched segments accept residential, work, or auto spatial matching; auto expands commercial workplace inputs. Segments are reusable cohort definitions that can be composed into audiences for delivery. Duplicate any segment via the duplicate_segment tool — the duplicate preserves the subtype and all subtype-specific data (referenced, never recomputed) with lineage tracking; filter duplicates start with a null count while other subtypes carry the source counts, and duplicating a matched segment whose match data is unavailable is rejected with a 409 conflict. Refresh a stale filter or matched segment against the current identity graph via the refresh_segment tool; custom snapshots return 409 CUSTOM_REGENERATION_REQUIRED and need a new internal publication — referencing audiences are never touched; archived segments and matched duplicates that share another segment's data are rejected with a 409. Use patch_segment to rename or replace a filter definition. Operate on one segment per action; archive_segment supports reversible archival and restoration. Requires 'creator' scope. For get_segment_demographics, get_segment_audiences, and count_segment (which require only 'discovery' scope but can meter compute or update cached state), submit under the segment-lookup skill instead.",
"tags": [
"segments",
"cohorts",
"management"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "segment-lookup",
"name": "Segment Lookup",
"description": "Segment inspection: get a demographic breakdown via get_segment_demographics (any subtype — non-filter segments resolve via the same ID-set composition audiences use), list the audiences that reference a segment (with campaign linkage) via get_segment_audiences, or recount via count_segment (runs a fresh BigQuery count for any subtype). Demographics and recount operations record non-commercial compute telemetry. Requires 'discovery' scope.",
"tags": [
"segments",
"demographics",
"counts"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "catalog",
"name": "Data Catalog",
"description": "Browse enrichment attributes, coverage and subscription capacity rates. Discover the available fields before selecting enrichment outputs. Requires 'discovery' scope.",
"tags": [
"catalog",
"fields",
"enrichment"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "identity-resolution",
"name": "Identity Resolution & Match History",
"description": "Resolve up to 100 contact records synchronously using residential, work or auto spatial matching, or process larger identity files through segment-management. Synchronous matching consumes subscription capacity for matched records when results are returned. File matching consumes capacity with the first successful delivery. Responses include match statistics and monetary consumption estimates in USD. History is available through match-history. Requires 'creator' scope; history reads require 'discovery' scope.",
"tags": [
"identity",
"matching",
"enrichment"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "match-history",
"name": "Match History",
"description": "Retrieve cursor-paginated micro-batch and file matching history from POST /v1/match and POST /v1/match/file. Results include run or match identifiers, counts, match rate, status, timestamps and subscription capacity consumption estimates in USD. File-job matching consumption becomes available after first successful delivery. Requires 'discovery' scope.",
"tags": [
"matching",
"history",
"status"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "integration-result-history",
"name": "Integration Result History",
"description": "List or retrieve safe, retained integration activity without exposing private workflow artifacts. Results include provenance, counts, selected fields, subscription capacity source, promotion deadline, and durable Library links. Requires 'discovery' scope.",
"tags": [
"integrations",
"history",
"results"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "integration-result-promotion",
"name": "Save Integration Result",
"description": "Preview saved integration matches, then create or extend a matched Segment using already-settled identities. Confirm the preview and target with the user. A stable request_id makes retries idempotent; this reuses existing enrichment capacity. It does not create an Audience automatically; compose one separately when needed. Requires 'creator' scope.",
"tags": [
"integrations",
"segments",
"audiences"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "delivery-history",
"name": "Delivery History",
"description": "List existing deliveries for an audience, a file-based match job, or the organization. Filter by status, destination or audience and continue with the returned cursor. Results include record counts, subscription capacity consumption, output format, compression and timestamps. Monetary amounts are denominated in USD. Requires 'discovery' scope.",
"tags": [
"delivery",
"history",
"status"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "pricing",
"name": "Pricing & Quoting",
"description": "Estimate expected and upper-bound subscription capacity for an audience download, denominated in USD. Existing licenses reduce the expected identity component; applicable file matching capacity is included separately. Review both estimates and available capacity before delivery. Saves an estimate for the current audience. Requires 'discovery' scope.",
"tags": [
"pricing",
"quotes",
"delivery"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "data-purchase",
"name": "Audience Delivery",
"description": "Deliver a saved audience as a download using available organization subscription capacity. Supports CSV, JSON, JSONL and Avro, with explicit output compression. The first successful file-match delivery also consumes its matching capacity. Retained, already-covered deliveries support re-export under existing coverage. Review the pricing skill's capacity estimate before delivery. Requires 'creator' scope.",
"tags": [
"audiences",
"delivery",
"activation"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "delivery-status",
"name": "Delivery Status",
"description": "Check the status and download URLs for a specific delivery. Poll after initiating a delivery to determine when records are ready. Note: download_urls are short-lived presigned GCS URLs regenerated fresh on every GET — do not cache them. Requires 'discovery' scope.",
"tags": [
"delivery",
"status",
"downloads"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "account-info",
"name": "Account & Balance",
"description": "Read existing organization subscription capacity, active reservations, pending consumption, replenishment state, readiness and snapshot freshness. Monetary amounts identify their currency and denomination. Agency-managed organizations receive their own attributed consumption. Requires 'account-read' scope (or account scope for existing API keys).",
"tags": [
"account",
"usage",
"balance"
],
"examples": [],
"inputModes": [],
"outputModes": []
},
{
"id": "campaign-management",
"name": "Campaign Management",
"description": "Create, update, and archive campaign workspaces, including their campaign brief and goals. Link or unlink audiences from campaigns — a campaign holds many audiences, an audience belongs to at most one. Pass metadata.campaign_id to supply an active campaign context for the turn; audiences created in that turn join it, and segments record it as their origin_campaign_id. Requires 'creator' scope. For read-only campaign list and detail requests, submit under the campaign-lookup skill instead — it only requires 'discovery' scope.",
"tags": [
"campaigns",
"audiences",
"workspace"
],
"examples": [
"Create a new campaign called Q3 Prospecting with goals for acquiring regional retail customers",
"Link audience abc123 to campaign xyz789"
],
"inputModes": [],
"outputModes": []
},
{
"id": "campaign-lookup",
"name": "Campaign Lookup",
"description": "Read-only campaign inspection: list campaigns or get a single campaign's brief and linked audiences. Pass metadata.campaign_id to supply an active campaign context for the turn. Requires 'discovery' scope.",
"tags": [
"campaigns",
"audiences",
"workspace"
],
"examples": [
"List my active campaigns",
"Show recent deliveries for campaign xyz789"
],
"inputModes": [],
"outputModes": []
}
],
"conformance": true,
"conformance_errors": null,
"homepage": null,
"repository": null,
"license": null,
"pricing": null,
"contact": null,
"id": "acb6a428-66c8-4a95-a7ef-52f6eca79870",
"category": "commerce-marketing",
"category_secondary": null
}