MCP Tool Reference

Every tool exposed by the BPP MCP Server, grouped by area. All tools are automatically scoped to your customer workspace.

External access indicates whether the tool is available to external clients (Claude, ChatGPT, …) using a personal MCP credential. Tools marked Copilot only are reserved to the in-product Copilot, where write actions require your explicit approval; they are hidden from external tool discovery.

Audiences

Tool	Description	External access
list_audiences	List your audiences (id, name, status, dimension), with status/name filters and pagination.	✅
get_audience	Fetch a single audience, including its filters and current dimension.	✅
create_audience	Create a new audience in draft status.	✅
update_audience	Modify an existing audience (name, filters, dimension).	Copilot only
clone_audience	Duplicate an audience (with its destinations) into a new draft.	Copilot only
run_audience	Trigger an on-demand export run (per-customer daily cooldown).	Copilot only

Signals

Tool	Description	External access
list_signals	List your signals, with filters and pagination.	✅
get_signal	Fetch a single signal — filters, triggers, status, dimension.	✅
create_signal	Create a new signal in draft status.	✅
update_signal	Modify an existing signal.	Copilot only
clone_signal	Duplicate a signal (with its destinations) into a new draft.	Copilot only
run_signal	Trigger an on-demand run (per-customer cooldown).	Copilot only
preview_signal_stats	Estimate a signal's dimension and stats without saving it.	✅
validate_signal_formula	Validate a signal formula against your data schema.	✅

Fields & data

Tool	Description	External access
get_datasource	Describe your datasource (name, BigQuery dataset, location).	✅
list_tables	List your configured tables (user, event, summary, AI model results).	✅
list_fields	List field metadata for one or all tables, with identifier/numeric filters.	✅
preview_field_values	Most frequent non-null values for a field.	✅
field_data_quality	Data-quality stats for a field: counts, null %, distinct values, min/max.	✅
query_bigquery	Run an ad-hoc read-only query (SELECT/WITH) against your datasets, with byte and time caps.	✅
update_field_descriptions	Update label, description, or visibility on a table's fields.	Copilot only

Dimensions

Tool	Description	External access
list_identifier_types	List identifier types (EMAIL_SHA256, MAID, EXTERNAL_ID, …).	✅
list_field_operands	List the table/field operands allowed in formulas.	✅

Connections & destinations

Tool	Description	External access
list_connection_types	List the external platform types BPP can push to.	✅
list_connections	List your configured connections.	✅
get_connection	Fetch a single connection's details.	✅
list_audience_destinations	List audience ↔ connection bindings.	✅
list_signal_destinations	List signal ↔ connection bindings.	✅
list_google_ads_accounts	List the Google Ads accounts reachable from a connection.	✅
list_google_ads_conversion_actions	List conversion actions on a Google Ads connection.	✅
add_audience_destination	Bind an existing audience to a connection.	Copilot only
add_signal_destination	Bind an existing signal to a connection.	Copilot only

Identity graph

Tool	Description	External access
count_total_bpp_users	Total reconciled users in the identity graph.	✅
count_bpp_users_by_identifier_type	Unique users carrying each identifier type.	✅
identifier_type_coverage	Share of users carrying at least one identifier of a given type.	✅
lookup_bpp_user_by_identifier	Find the reconciled user behind an identifier value.	✅

AI models

Tool	Description	External access
list_ai_model_instances	List your AI model instances.	✅
get_ai_model_instance	Fetch a full AI model instance by id.	✅
list_ai_model_types	List the supported AI model types (RFM, Action Prediction, …).	✅
create_ai_model_instance	Create a draft AI model instance and return its setup link.	Copilot only
delete_ai_model_instance	Delete an AI model instance.	Copilot only