# RudderStack MCP Tool Reference

<p>The hosted endpoint exposes the following tools. Availability depends on your RudderStack plan, enabled products, workspace permissions, and server configuration. Tools use your RudderStack user and workspace permissions. There are no separate per-tool OAuth scopes.</p>
<ul>
<li><strong>Read</strong> tools inspect data without persisting a control-plane change.</li>
<li><strong>Sensitive execution</strong> tools don&rsquo;t persist control-plane configuration, but execute code or submit temporary warehouse work. Review and confirm these tool calls in your MCP client before running them. Don&rsquo;t configure agents to auto-approve them.</li>
<li><strong>Write</strong> tools persist session state or change control-plane configuration. Review and confirm these tool calls in your MCP client before running them.</li>
</ul>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="user-and-workspace-tools">User and workspace tools</h2><table>
  <thead>
      <tr>
          <th>Tool name</th>
          <th>Description</th>
          <th>Access</th>
          <th>Permission notes</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>user_details</code></td>
          <td>Gets the current user, accessible workspaces, and active workspace context.</td>
          <td>Read</td>
          <td>Authorized user access</td>
      </tr>
      <tr>
          <td><code>user_switch_workspace</code></td>
          <td>Changes and persists the active workspace for the MCP session.</td>
          <td>Write</td>
          <td>Access to the selected workspace</td>
      </tr>
      <tr>
          <td><code>get_workspace_settings</code></td>
          <td>Gets details and settings for the current workspace.</td>
          <td>Read</td>
          <td>Current workspace access</td>
      </tr>
      <tr>
          <td><code>list_connections</code></td>
          <td>Lists source-to-destination connections.</td>
          <td>Read</td>
          <td>Current workspace access</td>
      </tr>
      <tr>
          <td><code>get_billing_details</code></td>
          <td>Gets contract volume, plan, organization, and owner information.</td>
          <td>Read</td>
          <td>Authorized organization access</td>
      </tr>
  </tbody>
</table>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="source-tools">Source tools</h2><table>
  <thead>
      <tr>
          <th>Tool name</th>
          <th>Description</th>
          <th>Access</th>
          <th>Permission notes</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>list_sources</code></td>
          <td>Lists configured event stream and Reverse ETL sources.</td>
          <td>Read</td>
          <td>Source access</td>
      </tr>
      <tr>
          <td><code>get_source</code></td>
          <td>Gets source configuration, Tracking Plans, and connected destinations.</td>
          <td>Read</td>
          <td>Source access</td>
      </tr>
      <tr>
          <td><code>get_source_definitions</code></td>
          <td>Gets source definition metadata, schemas, and capabilities.</td>
          <td>Read</td>
          <td>Source access</td>
      </tr>
      <tr>
          <td><code>get_source_event_schemas</code></td>
          <td>Gets incoming event schemas for a source.</td>
          <td>Read</td>
          <td>Source access</td>
      </tr>
      <tr>
          <td><code>get_source_event_metrics</code></td>
          <td>Gets source event volume and filtering metrics.</td>
          <td>Read</td>
          <td>Source access</td>
      </tr>
      <tr>
          <td><code>get_source_tracking_plans_and_versions</code></td>
          <td>Gets a source&rsquo;s Tracking Plan associations and versions.</td>
          <td>Read</td>
          <td>Source and Tracking Plan access</td>
      </tr>
      <tr>
          <td><code>get_source_tracking_plan_event_metrics</code></td>
          <td>Gets Tracking Plan validation and violation metrics.</td>
          <td>Read</td>
          <td>Source and Tracking Plan access</td>
      </tr>
      <tr>
          <td><code>get_source_tracking_plan_event_violations</code></td>
          <td>Gets Tracking Plan validation failures and redacted samples when available.</td>
          <td>Read</td>
          <td>Source and Tracking Plan access</td>
      </tr>
      <tr>
          <td><code>get_source_event_names_similarity</code></td>
          <td>Finds similar or duplicate source event names.</td>
          <td>Read</td>
          <td>Source access</td>
      </tr>
      <tr>
          <td><code>get_source_event_properties</code></td>
          <td>Gets observed property types and frequency for an event.</td>
          <td>Read</td>
          <td>Source access</td>
      </tr>
  </tbody>
</table>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="destination-tools">Destination tools</h2><table>
  <thead>
      <tr>
          <th>Tool name</th>
          <th>Description</th>
          <th>Access</th>
          <th>Permission notes</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>list_destinations</code></td>
          <td>Lists workspace destinations.</td>
          <td>Read</td>
          <td>Destination access</td>
      </tr>
      <tr>
          <td><code>get_destination</code></td>
          <td>Gets destination configuration, connected sources, and transformations.</td>
          <td>Read</td>
          <td>Destination access</td>
      </tr>
      <tr>
          <td><code>get_destinations_errors</code></td>
          <td>Gets delivery failures and redacted samples when available.</td>
          <td>Read</td>
          <td>Destination access</td>
      </tr>
      <tr>
          <td><code>get_destination_event_metrics</code></td>
          <td>Gets delivery success, failure, and filtering metrics.</td>
          <td>Read</td>
          <td>Destination access</td>
      </tr>
      <tr>
          <td><code>get_destination_definitions</code></td>
          <td>Gets destination definition metadata, schemas, and capabilities.</td>
          <td>Read</td>
          <td>Destination access</td>
      </tr>
      <tr>
          <td><code>get_destination_latency_metrics</code></td>
          <td>Gets destination latency over time.</td>
          <td>Read</td>
          <td>Destination access</td>
      </tr>
  </tbody>
</table>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="transformation-and-library-tools">Transformation and library tools</h2><table>
  <thead>
      <tr>
          <th>Tool name</th>
          <th>Description</th>
          <th>Access</th>
          <th>Permission notes</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>transformation_test_new</code></td>
          <td>Executes unsaved JavaScript or Python transformation code against supplied events without saving it.</td>
          <td>Sensitive execution</td>
          <td>Transformation access; code can make outbound requests</td>
      </tr>
      <tr>
          <td><code>transformation_test_existing</code></td>
          <td>Executes a saved transformation against supplied events without changing it.</td>
          <td>Sensitive execution</td>
          <td>Transformation access; code can make outbound requests</td>
      </tr>
      <tr>
          <td><code>sample_transformations</code></td>
          <td>Lists pre-built transformation templates.</td>
          <td>Read</td>
          <td>Transformation access</td>
      </tr>
      <tr>
          <td><code>upsert_transformation</code></td>
          <td>Creates or updates a JavaScript or Python transformation.</td>
          <td>Write</td>
          <td>Transformation write access</td>
      </tr>
      <tr>
          <td><code>connect_transformation_destination</code></td>
          <td>Attaches a transformation to a destination.</td>
          <td>Write</td>
          <td>Transformation and destination write access</td>
      </tr>
      <tr>
          <td><code>list_transformations</code></td>
          <td>Lists transformations and their destination connections.</td>
          <td>Read</td>
          <td>Transformation access</td>
      </tr>
      <tr>
          <td><code>get_transformation</code></td>
          <td>Gets transformation details, source code, and configuration.</td>
          <td>Read</td>
          <td>Transformation access</td>
      </tr>
      <tr>
          <td><code>get_transformation_event_metrics</code></td>
          <td>Gets transformation volumes, outcomes, and errors over time.</td>
          <td>Read</td>
          <td>Transformation access</td>
      </tr>
      <tr>
          <td><code>get_transformation_latency_metrics</code></td>
          <td>Gets transformation latency over time.</td>
          <td>Read</td>
          <td>Transformation access</td>
      </tr>
      <tr>
          <td><code>list_transformation_libraries</code></td>
          <td>Lists custom workspace transformation libraries.</td>
          <td>Read</td>
          <td>Transformation library access</td>
      </tr>
      <tr>
          <td><code>get_transformation_library</code></td>
          <td>Gets a custom transformation library, including source code.</td>
          <td>Read</td>
          <td>Transformation library access</td>
      </tr>
      <tr>
          <td><code>list_rudderstack_transformation_libraries</code></td>
          <td>Lists pre-built RudderStack transformation libraries.</td>
          <td>Read</td>
          <td>Transformation access</td>
      </tr>
  </tbody>
</table>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="warehouse-reverse-etl-tracking-plan-and-data-catalog-tools">Warehouse, Reverse ETL, Tracking Plan, and Data Catalog tools</h2><table>
  <thead>
      <tr>
          <th>Tool name</th>
          <th>Description</th>
          <th>Access</th>
          <th>Permission notes</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>get_warehouse_uploads</code></td>
          <td>Gets warehouse upload history, status, and optional table details.</td>
          <td>Read</td>
          <td>Warehouse destination access</td>
      </tr>
      <tr>
          <td><code>get_warehouse_upload_with_tables</code></td>
          <td>Gets table-level details for one warehouse upload.</td>
          <td>Read</td>
          <td>Warehouse destination access</td>
      </tr>
      <tr>
          <td><code>get_retl_source_syncs</code></td>
          <td>Gets Reverse ETL sync results, metrics, and timing.</td>
          <td>Read</td>
          <td>Reverse ETL source access</td>
      </tr>
      <tr>
          <td><code>list_tracking_plans</code></td>
          <td>Lists Tracking Plans and governance rules.</td>
          <td>Read</td>
          <td>Tracking Plan access</td>
      </tr>
      <tr>
          <td><code>list_tracking_plan_events</code></td>
          <td>Lists Tracking Plan events and optional schemas.</td>
          <td>Read</td>
          <td>Tracking Plan access</td>
      </tr>
      <tr>
          <td><code>list_data_catalog_events</code></td>
          <td>Lists events in the Data Catalog.</td>
          <td>Read</td>
          <td>Data Catalog access</td>
      </tr>
      <tr>
          <td><code>list_data_catalog_properties</code></td>
          <td>Lists event properties in the Data Catalog.</td>
          <td>Read</td>
          <td>Data Catalog access</td>
      </tr>
  </tbody>
</table>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="live-event-and-profile-tools">Live event and profile tools</h2><table>
  <thead>
      <tr>
          <th>Tool name</th>
          <th>Description</th>
          <th>Access</th>
          <th>Permission notes</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>get_live_events</code></td>
          <td>Polls real-time source, destination, and transformation events. Turns on live-event capture for the selected entity.</td>
          <td>Read</td>
          <td>Pipeline access — the server doesn&rsquo;t annotate this tool as read-only because it enables live-event capture, though it changes no configuration. Live event content can be sensitive even when fields are redacted or hashed</td>
      </tr>
      <tr>
          <td><code>list_profiles</code></td>
          <td>Lists profile projects for the workspace.</td>
          <td>Read</td>
          <td>Profiles access</td>
      </tr>
      <tr>
          <td><code>get_profile_details</code></td>
          <td>Gets profile models, statistics, cohort features, or history.</td>
          <td>Read</td>
          <td>Profiles access</td>
      </tr>
      <tr>
          <td><code>get_profile_artifacts</code></td>
          <td>Lists task artifacts or retrieves artifact file content.</td>
          <td>Read</td>
          <td>Profiles access</td>
      </tr>
  </tbody>
</table>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="audit-log-and-audience-tools">Audit log and audience tools</h2><table>
  <thead>
      <tr>
          <th>Tool name</th>
          <th>Description</th>
          <th>Access</th>
          <th>Permission notes</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>audit_logs</code></td>
          <td>Lists workspace audit log entries.</td>
          <td>Read</td>
          <td>Audit log access</td>
      </tr>
      <tr>
          <td><code>list_audience_subjects</code></td>
          <td>Lists data graph entities that can be audience subjects.</td>
          <td>Read</td>
          <td>Profiles and Audiences access</td>
      </tr>
      <tr>
          <td><code>get_audience_model_context</code></td>
          <td>Gets model attributes, relationships, neighbors, and peer audiences.</td>
          <td>Read</td>
          <td>Profiles and Audiences access</td>
      </tr>
      <tr>
          <td><code>load_audience_skill</code></td>
          <td>Loads the audience expression grammar used to construct valid requests.</td>
          <td>Read</td>
          <td>Profiles and Audiences access</td>
      </tr>
      <tr>
          <td><code>create_audience</code></td>
          <td>Creates and persists a data graph audience.</td>
          <td>Write</td>
          <td>Audience write access</td>
      </tr>
      <tr>
          <td><code>update_audience</code></td>
          <td>Updates a persisted data graph audience.</td>
          <td>Write</td>
          <td>Audience write access</td>
      </tr>
      <tr>
          <td><code>get_audience</code></td>
          <td>Gets an audience and its stored expression and metadata.</td>
          <td>Read</td>
          <td>Audience access</td>
      </tr>
      <tr>
          <td><code>preview_audience</code></td>
          <td>Submits temporary warehouse work to estimate audience size.</td>
          <td>Sensitive execution</td>
          <td>Profiles, Audiences, and warehouse access</td>
      </tr>
  </tbody>
</table>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="activation-tools">Activation tools</h2><p><code>get_audience_destination_schema</code> and <code>connect_audience_destination</code> are always available. The hosted server exposes the remaining four tools in this section only when audience activation is enabled for your workspace.</p>
<table>
  <thead>
      <tr>
          <th>Tool name</th>
          <th>Description</th>
          <th>Access</th>
          <th>Permission notes</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>get_audience_destination_schema</code></td>
          <td>Gets valid destination fields and destination-side audiences.</td>
          <td>Read</td>
          <td>Audience and destination access</td>
      </tr>
      <tr>
          <td><code>connect_audience_destination</code></td>
          <td>Persists an audience-to-destination activation connection.</td>
          <td>Write</td>
          <td>Audience and destination write access</td>
      </tr>
      <tr>
          <td><code>plan_audience_activation</code></td>
          <td>Plans a destination activation for an audience before creating resources.</td>
          <td>Read</td>
          <td>Audience and destination access; requires the audience activation feature</td>
      </tr>
      <tr>
          <td><code>create_audience_activation</code></td>
          <td>Creates audience activation resources, including the destination and Reverse ETL sync required for activation.</td>
          <td>Write</td>
          <td>Audience, destination, and Reverse ETL write access; requires the audience activation feature</td>
      </tr>
      <tr>
          <td><code>trigger_sync</code></td>
          <td>Starts an activation sync run. This can update or remove members in the downstream ad-platform audience depending on the configured sync.</td>
          <td>Write</td>
          <td>Audience and Reverse ETL write access; requires the audience activation feature</td>
      </tr>
      <tr>
          <td><code>list_sync_runs</code></td>
          <td>Lists activation sync runs and their statuses.</td>
          <td>Read</td>
          <td>Audience and Reverse ETL access; requires the audience activation feature</td>
      </tr>
  </tbody>
</table>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="documentation-and-service-status-tools">Documentation and service status tools</h2><p>The hosted server exposes these tools only when the corresponding integration is configured.</p>
<table>
  <thead>
      <tr>
          <th>Tool name</th>
          <th>Description</th>
          <th>Access</th>
          <th>Permission notes</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>search_docs</code></td>
          <td>Searches RudderStack documentation.</td>
          <td>Read</td>
          <td>Requires the documentation integration</td>
      </tr>
      <tr>
          <td><code>ask_docs</code></td>
          <td>Gets a documentation-grounded answer with citations.</td>
          <td>Read</td>
          <td>Requires the documentation integration</td>
      </tr>
      <tr>
          <td><code>list_statuspage_incidents</code></td>
          <td>Lists recent RudderStack status page incidents.</td>
          <td>Read</td>
          <td>Requires the Statuspage integration</td>
      </tr>
      <tr>
          <td><code>get_statuspage_incident</code></td>
          <td>Gets an incident, its updates, and affected components.</td>
          <td>Read</td>
          <td>Requires the Statuspage integration</td>
      </tr>
  </tbody>
</table>
<p>When all optional integrations and audience activation are configured, the hosted endpoint exposes 62 tools: 51 read tools, three sensitive execution tools, and eight write tools.</p>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="see-more">See more</h2><ul>
<li><a href="https://www.rudderstack.com/docs/ai-features/rudderstack-mcp/" >RudderStack MCP</a>: Covers capabilities, example prompts, and security considerations.</li>
<li><a href="https://www.rudderstack.com/docs/ai-features/rudderstack-mcp/connect/" >How to Set Up RudderStack MCP</a>: Connect an MCP client and complete OAuth.</li>
</ul>