MCP tool reference

The Amperity MCP server exposes tools across the Amperity surface. Tool names follow a domain_action convention, such as tenant_list or database_create_table.

For the canonical list available to your account, send a tools/list request from your MCP client. Many clients do this automatically on connect. The list of tools returned by tools/list is the exact tool surface your account is authorized to call.

Tenants and sessions

Manage which Amperity tenant the current session targets, and read session-level safety configuration.

Description	Tools
List, inspect, switch, and refresh tenants	tenant_list tenant_info tenant_use tenant_resync
Manage sandbox tenants	sandbox_list sandbox_create sandbox_get_create_status sandbox_delete
Inspect and merge sandbox state	sandbox_get_status sandbox_compare sandbox_get_merge_warnings sandbox_pull sandbox_push
Read and set the session safety mode	safety_get_mode safety_set_mode

Databases and tables

Operate Amperity Customer 360 databases, datasets, and the underlying tables.

Description	Tools
Inspect databases	database_list database_get_schema database_get_table database_list_tables
Create and update databases and tables	database_create database_create_table database_update database_update_table
Manage database lifecycle	database_activate database_run database_discard
Delete databases and tables	database_delete database_delete_table
Inspect validation reports	database_get_validation_report database_list_validation_reports
Read dataset catalogs and tables	dataset_get_catalog dataset_list_tables dataset_get_table
Manage core tables	core_table_list core_table_get core_table_get_tenant_schema core_table_analyze core_table_upsert core_table_delete
Manage domain transforms	domain_transform_list domain_transform_get domain_transform_upsert domain_transform_analyze domain_transform_delete
Inspect domain table history	domain_table_history_get_history
Inspect run history for tables	table_run_history_list_runs table_run_history_get_run table_run_history_get_table_history

Queries

Author, run, and organize queries against Amperity data.

Description	Tools
Manage queries	queries_list queries_get queries_create queries_update queries_delete
Run and manage query lifecycle	queries_run queries_activate queries_discard queries_move
Run ad hoc queries and inspect column statistics	query_run query_get_column_stats
Organize queries into folders	query_folder_list query_folder_get query_folder_create query_folder_update query_folder_delete

Identity resolution

Run, inspect, and tune identity resolution.

Description	Tools
Run Stitch	stitch_run
Inspect Stitch results and explain match pairs	stitch_get_report stitch_list_recent_reports stitch_lookup_record stitch_explain_pair
Read and update Stitch configuration	stitch_get_settings stitch_update_settings stitch_set_table_availability
Review benchmark coverage	stitch_list_benchmarks stitch_get_benchmark_examples stitch_get_benchmark_history

Amperity Bridge

Manage data bridges between Amperity and external systems.

Description	Tools
Manage bridge configuration	bridge_list bridge_get bridge_create bridge_update bridge_delete
Control bridge connection state	bridge_connect bridge_disconnect
Run and inspect bridge syncs	bridge_run_sync bridge_get_sync bridge_update_sync
Manage share configuration	bridge_create_share bridge_get_share bridge_delete_share bridge_list_share_tables
Manage bridge credentials	bridge_upload_credential bridge_download_credential
Load Amperity data through a bridge	bridge_load_amperity_data

Couriers, feeds, and destinations

Configure data movement into and out of Amperity.

Description	Tools
Manage couriers	courier_list courier_get courier_create courier_update courier_delete courier_run
Manage courier groups	courier_group_list courier_group_get courier_group_create courier_group_update courier_group_delete courier_group_run
Manage feeds	feed_list feed_get feed_upsert feed_delete
Manage destinations	destination_list destination_get destination_create destination_update destination_delete
Manage destination target templates	destination_list_target_templates destination_get_target_template destination_create_target_template destination_delete_target_template

Orchestrations

Schedule and run orchestrations and orchestration groups.

Description	Tools
Manage orchestrations	orchestration_list orchestration_get orchestration_create orchestration_update orchestration_delete
Manage orchestration groups	orchestration_group_list orchestration_group_get orchestration_group_create orchestration_group_update orchestration_group_delete orchestration_group_run

Campaigns and journeys

Manage campaigns, campaign folders, journeys, and audiences.

Description	Tools
Manage campaigns	campaign_list campaign_get campaign_create campaign_update campaign_delete campaign_duplicate campaign_move
Schedule or unschedule a campaign send	campaign_schedule
Manage campaign folders	campaign_folder_list campaign_folder_get campaign_folder_create campaign_folder_update campaign_folder_delete
Manage journeys	journey_list journey_get journey_create journey_update journey_delete
Manage labels	label_list label_get label_create label_update label_delete

Data exports

Manage data exports.

Description	Tools
Manage database export slices (slc-xxx)	slice_list slice_get slice_create slice_update slice_delete

Predictions

Configure and run prediction models.

Description	Tools
Model lifecycle	prediction_list_models prediction_get_model prediction_create_model prediction_update_model prediction_delete_model
Model configuration	prediction_list_model_configs prediction_get_model_config prediction_create_model_config prediction_delete_model_config prediction_activate_model_config prediction_save_model_settings
Run and inspect prediction workflows	prediction_run_workflow prediction_get_run_history prediction_get_full_job_history
Inspect validation output	prediction_get_validation_results prediction_get_model_config_validation_results

Profile collections and realtime segments

Manage profile collections and realtime segments.

Description	Tools
Manage profile collections	profile_collection_list profile_collection_get profile_collection_create profile_collection_update profile_collection_delete
Manage attributes and runs	profile_collection_set_attribute profile_collection_delete_attribute profile_collection_refresh profile_collection_run
Manage realtime segments	real_time_segment_list real_time_segment_get real_time_segment_create real_time_segment_update real_time_segment_delete

Events

Manage event streams and event types.

Description	Tools
Manage event streams	event_stream_list event_stream_get event_stream_create event_stream_update event_stream_delete event_stream_get_recent_events
Manage event type definitions	event_type_list event_type_get event_type_create event_type_update event_type_delete

Segments

Manage segments and folders.

Description	Tools
Manage segments	iq_list iq_get iq_create iq_update iq_delete iq_activate
Manage segments folders	iq_folder_list iq_folder_get iq_folder_create iq_folder_update iq_folder_delete
Read company context assets	assets_list_company_context_documents assets_get_company_context_document

Configuration history and recovery

Inspect configuration changes and revert to prior versions.

Description	Tools
Search and inspect configuration history	config_history_search config_history_get_version_nodes config_history_diff_node
Compare and revert configuration	config_revert_compare_revert config_revert_revert
Inspect the configuration computation graph	comp_graph_get comp_graph_get_dependents comp_graph_get_dependencies

Workflows and compute

Inspect Amperity workflows and Spark execution.

Description	Tools
Inspect and manage workflows	workflow_list workflow_get_status workflow_cancel workflow_resolve_task
Inspect Spark applications, jobs, stages, executors, SQL, and storage	spark_get_application spark_list_jobs spark_list_stages spark_get_stage spark_list_sql spark_get_sql spark_list_executors spark_get_environment spark_list_storage
Read and update compute settings	compute_get_settings compute_update_settings

Alerts and training

Manage alert subscriptions and run training tasks for semantic tagging.

Description	Tools
Manage alert subscriptions	alert_list_subscriptions alert_get_subscription alert_subscribe alert_unsubscribe
Run training tasks for semantic tagging	training_setup_semantic_tags