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

Begin a session and mint a session token (hosted multi-user clients call this first)

session_start

List, inspect, switch, and refresh tenants

tenant_list

tenant_info

tenant_use

tenant_resync

Manage sandbox tenants

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

Submit feedback to the Amperity team

feedback_submit

File an Amperity support ticket

support_ticket_create

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_results

query_get_column_stats

Organize queries into folders

query_folder_list

query_folder_get

query_folder_create

query_folder_update

query_folder_delete

Signal dashboard

Manage Signal boards — the dashboard’s tabs — and the cards on them. Each card names its own database and table, and declares the measure, dimension, and filter it renders rather than carrying SQL.

Description

Tools

Manage boards

signal_board_list

signal_board_get

signal_board_upsert

signal_board_delete

Manage the cards on a board

signal_viz_list

signal_viz_get

signal_viz_upsert

signal_viz_delete

Read the Signal authoring reference

signal_get_authoring_reference

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 data sources (the objects feeds attach to)

source_list

source_create

Manage destinations

destination_list

destination_get

destination_create

destination_update

destination_delete

Manage destination attribute sets

destination_create_attribute_set

destination_delete_attribute_set

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 journey folders

journey_folder_list

journey_folder_get

journey_folder_upsert

journey_folder_delete

Run, schedule, and unschedule journeys

journey_run

journey_schedule

journey_unschedule

Read the journey authoring reference

journey_get_authoring_reference

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

Manage prediction variants

prediction_list_variants

prediction_get_variant

prediction_create_variant

prediction_delete_variant

Validate and inspect prediction variants

prediction_validate_variant

prediction_get_variant_metrics

Run prediction models

prediction_run_model

Segments

Manage segments and folders.

Description

Tools

Manage segments

segment_list

segment_get

segment_create

segment_update

segment_delete

segment_activate

Manage segments folders

segment_folder_list

segment_folder_get

segment_folder_create

segment_folder_update

segment_folder_delete

Manage company context documents

context_documents_list

context_documents_get

context_documents_create

Read the tenant’s AmpAI system prompt

ai_system_prompt_get

Real-time profiles and events

Configure the real-time surface: event streams and their event types, profile collections and their attributes, and real-time segments.

Description

Tools

Manage event streams

event_stream_list

event_stream_get

event_stream_upsert

event_stream_delete

Inspect recent events on a stream

event_stream_get_recent_events

Manage event types on a stream

event_type_list

event_type_get

event_type_upsert

event_type_delete

Manage profile collections

profile_collection_list

profile_collection_get

profile_collection_upsert

profile_collection_delete

Manage profile collection attributes

profile_collection_set_attribute

profile_collection_delete_attribute

Recompute profiles

profile_collection_run

Look up an individual’s live profile and its segment membership (returns customer data; requires PII read permissions)

profile_lookup

profile_list_segments

Manage real-time segments

real_time_segment_list

real_time_segment_get

real_time_segment_upsert

real_time_segment_delete

Labels

Manage labels.

Description

Tools

Manage labels

label_list

label_get

label_create

label_update

label_delete

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_get_task

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