DocumentationTargetTarget Guide

[Beta]{class="badge informative"}

Adobe Target MCP server tools reference target-mcp-tools-reference

Last update: May 12, 2026

CREATED FOR:

  • Intermediate
  • Experienced
  • Developer
  • User
AVAILABILITY
The Adobe Target MCP server is available to all customers in Public Beta. It is currently supported in Claude Web, Claude Desktop, Claude Code, Cursor, and ChatGPT.

This page is a complete reference for all read-only tools exposed by the Adobe Target MCP server. For each tool you’ll find a description, parameter details, return value, and an example natural-language prompt. For setup instructions and use cases, see Get started and Use cases and walkthroughs.

IMPORTANT
The Model Context Protocol (MCP) is an emerging open-source standard and may present security or reliability risks. Adobe MCP server integrations and related documentation are provided “as is,” without warranties of any kind.
Connecting MCP clients or servers to Adobe products is a customer-elected configuration, and customers are responsible for evaluating the security and suitability of any MCP integration. Adobe is not responsible for issues arising from misconfiguration, misuse of the MCP, vulnerabilities in third-party implementations, or unintended actions performed through MCP-enabled workflows.
To reduce risk, Adobe encourages testing integrations in a sandbox environment prior to productive use and carefully reviewing and validating all MCP-initiated actions and responses before confirming or relying on them.

Prerequisites tools-prerequisites

Your Adobe Target role determines which tools are available to you:

  • Observer role or higher: access to all 23 read-only tools
NOTE
Write tools (create, update, activate, deactivate) are not exposed via the public MCP catalog in Public Beta. All 23 tools listed on this page are read-only. Write access will be available in a future release.

For full setup instructions, see Get started.

Activity tools tools-activities

List activities

Tool: list_target_activities

List Adobe Target activities with server-side filtering and sorting.

Retrieves a paginated list of activities. All filters are applied server-side by the Target Admin API. The server returns at most 200 activities per page.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4
Parameter Type Required Description
limit integer No Maximum number of activities to return (server max: 200)
offset integer No Number of activities to skip for pagination
sort_by string No Field to sort by. Prefix with - for descending order (e.g., -modifiedAt). Options: id, name, state, priority, startsAt, endsAt, lifetimeStart, lifetimeEnd, createdAt, createdBy, modifiedAt, modifiedBy, type, thirdPartyId
state string No Filter by activity state: approved (live/active), deactivated (inactive), paused, saved (draft)
activity_type string No Filter by type: ab (A/B Test), xt (Experience Targeting), abt (Automated Personalization)
name_contains string No Filter activities whose name contains this string (case-insensitive)
starts_after string No ISO 8601 date — activities starting after this date
starts_before string No ISO 8601 date — activities starting before this date
modified_after string No ISO 8601 date — activities modified after this date
ends_after string No ISO 8601 date — activities ending after this date
ends_before string No ISO 8601 date — activities ending before this date
workspace string No Filter by workspace ID
segment_id string No Filter by audience segment ID
profile_attribute_id string No Filter by profile attribute ID
priority integer No Filter by exact priority value (0–999)
mbox string No Filter by mbox/location name
offer_id string No Filter by offer ID
view_id string No Filter by SPA view ID

Returns: JSON object with activities (list of objects including id, name, state, type, priority, modifiedAt, startsAt, endsAt) and total (total count, may exceed the returned page size).

Example prompt: “List all active A/B tests sorted by most recently modified.”

Get an A/B activity

Tool: get_ab_activity

Get detailed information about an A/B activity.

Retrieves the full configuration of a specific A/B test, including experiences, locations, metrics, and targeting rules.

table 0-row-4 1-row-4
Parameter Type Required Description
activity_id integer Yes The unique identifier of the A/B activity

Returns: Full activity details including metadata (name, state, priority, dates), experiences, locations and offers, goals and metrics, and targeting rules.

Example prompt: “Get details for A/B activity 12345.”

Get an Experience Targeting activity

Tool: get_xt_activity

Get detailed information about an Experience Targeting (XT) activity.

Retrieves the full configuration of a specific XT activity, including audience-experience mappings, locations, and metrics.

table 0-row-4 1-row-4
Parameter Type Required Description
activity_id integer Yes The unique identifier of the XT activity

Returns: Full activity details including metadata, experiences with audience mappings, locations and offers, and goals and metrics.

Example prompt: “Get details for Experience Targeting activity 12345.”

Get an Automated Personalization activity

Tool: get_abt_activity

Get detailed information about an Automated Personalization (AP) activity.

table 0-row-4 1-row-4
Parameter Type Required Description
activity_id integer Yes The unique identifier of the AP activity

Returns: Full activity details including metadata, experiences, locations, and algorithmic settings.

Example prompt: “Get details for Auto-Personalization activity 12345.”

Offer tools tools-offers

List offers

Tool: list_target_offers

List all offers in your Target tenant.

Retrieves a paginated list of content offers with optional filtering.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parameter Type Required Description
limit integer No Maximum number of offers to return
offset integer No Number of offers to skip for pagination
type string No Filter by offer type: content (HTML), json, or redirect
name string No Filter by offer name (partial match)

Returns: JSON object with offers (list of objects including id, name, type, content, modifiedAt) and total.

Example prompt: “List all JSON offers.”

Get an offer

Tool: get_target_offer

Get detailed information about a specific offer.

table 0-row-4 1-row-4
Parameter Type Required Description
offer_id integer Yes The unique identifier of the offer

Returns: Full offer details including id, name, type, content, workspace, and modifiedAt.

Example prompt: “Get details for offer 67890.”

Audience tools tools-audiences

List audiences

Tool: list_target_audiences

List all audiences in your Target tenant.

table 0-row-4 1-row-4 2-row-4
Parameter Type Required Description
limit integer No Maximum number of audiences to return
offset integer No Number of audiences to skip for pagination

Returns: JSON object with audiences (list of objects including id, name, description, origin, modifiedAt) and total.

Example prompt: “List all audiences.”

Get an audience

Tool: get_target_audience

Get audience details including targeting rules.

Retrieves the full configuration of a specific audience, including its targeting rules and conditions.

table 0-row-4 1-row-4
Parameter Type Required Description
audience_id integer Yes The unique identifier of the audience

Returns: Full audience details including id, name, description, origin, targeting rules, and associated activity count.

Example prompt: “Get details for audience 12345 and show me its targeting rules.”

Mbox tools tools-mboxes

List mboxes

Tool: list_target_mboxes

List all mboxes in your Target tenant.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parameter Type Required Description
limit integer No Maximum number of mboxes to return
offset integer No Number of mboxes to skip for pagination
name string No Filter by mbox name (partial match)
status string No Filter by status

Returns: JSON object with mboxes (list of objects including name, status, lastRequestTime) and total.

Example prompt: “List all mboxes containing ‘homepage’.”

Get an mbox

Tool: get_target_mbox

Get detailed information about a specific mbox.

table 0-row-4 1-row-4
Parameter Type Required Description
mbox_name string Yes The name of the mbox

Returns: Mbox details including name, status, and list of activities using the mbox.

Example prompt: “Get details for mbox ‘homepage-hero’.”

List mbox profile attributes

Tool: list_target_mbox_profile_attributes

List all mbox profile attributes available for targeting.

No parameters required.

Returns: JSON array of profile attribute objects.

Example prompt: “What profile attributes are available for targeting?”

Property tools tools-properties

List properties

Tool: list_target_properties

List all properties in your Target tenant.

Properties organize activities and control access.

No parameters required.

Returns: List of property objects including id, name, description, and channel.

Example prompt: “List all Target properties.”

Reporting tools tools-reporting

Get an A/B performance report

Tool: get_ab_performance_report

Get a performance report for an A/B activity.

Retrieves conversion rates, lift, and confidence levels.

table 0-row-4 1-row-4 2-row-4
Parameter Type Required Description
activity_id integer Yes The unique identifier of the A/B activity
report_interval string No Time period for the report (e.g., last7days, last30days, or a custom date range)

Returns: Experience-level metrics (visitors, conversions, conversion rate), lift calculations, statistical confidence levels, and revenue metrics (if configured).

Example prompt: “Show me the performance report for A/B test 12345 over the last 30 days.”

Get an A/B orders report

Tool: get_ab_orders_report

Get an orders/revenue report for an A/B activity.

table 0-row-4 1-row-4 2-row-4
Parameter Type Required Description
activity_id integer Yes The unique identifier of the A/B activity
report_interval string No Time period for the report

Returns: Order counts, revenue, and average order value by experience.

Example prompt: “Get the orders report for activity 12345.”

Get an Experience Targeting performance report

Tool: get_xt_performance_report

Get a performance report for an Experience Targeting activity.

table 0-row-4 1-row-4 2-row-4
Parameter Type Required Description
activity_id integer Yes The unique identifier of the XT activity
report_interval string No Time period for the report

Returns: Experience-level performance metrics.

Example prompt: “Show performance for my Experience Targeting activity 54321.”

Get an Experience Targeting orders report

Tool: get_xt_orders_report

Get an orders/revenue report for an Experience Targeting activity.

table 0-row-4 1-row-4 2-row-4
Parameter Type Required Description
activity_id integer Yes The unique identifier of the XT activity
report_interval string No Time period for the report

Returns: Order metrics by experience.

Example prompt: “Get orders data for XT activity 54321.”

Get a performance report by activity name

Tool: get_activity_report_by_name

Search for an activity by name and get its performance report.

Useful when you know the activity name but not its ID.

table 0-row-4 1-row-4 2-row-4
Parameter Type Required Description
activity_name string Yes Name of the activity to search for
report_interval string No Time period for the report

Returns: Activity details and performance metrics.

Example prompt: “Get the performance report for my ‘Homepage Hero Test’ activity.”

Get an Analytics for Target (A4T) report

Tool: get_a4t_report

Fetch an Analytics for Target (A4T) report for a Target activity.

Validates the A4T configuration for the activity, then executes GraphQL queries against Adobe Analytics to retrieve Analytics-side metrics. Only available for activities that have A4T reporting configured.

table 0-row-4 1-row-4 2-row-4
Parameter Type Required Description
activity_id integer Yes The unique identifier of the Target activity
report_interval string No Time period for the report (e.g., last7days, last30days, or a custom date range)

Returns: Analytics-side metrics for the activity including visitor counts, conversions, revenue, and lift by experience, sourced directly from Adobe Analytics.

Example prompt: “Pull the A4T report for my checkout optimization test and summarize the Analytics-side conversion data.”

Preview tools tools-preview

Preview an activity

Tool: preview_activity

Generate browser QA preview URLs for a Target activity.

Creates clickable preview links that force specific experiences to display, bypassing audience targeting rules. Works for A/B, XT, and Automated Personalization activities.

table 0-row-4 1-row-4 2-row-4 3-row-4
Parameter Type Required Description
activity_id integer Yes The Target activity ID to preview
experience_index integer No 0-based experience index. If omitted, returns URLs for all experiences
url string No Page URL for preview. Required for form-based activities. For VEC activities, overrides the authored location if provided

Returns: Activity information (name, type, state), preview URLs for each experience, and experience names and indexes.

Example prompt: “Generate preview URLs for activity 12345 so I can test each experience in my browser.”

Response token tools tools-response-tokens

List response tokens

Tool: list_target_response_tokens

List all response tokens in your Target tenant.

Retrieves all configured response tokens, both built-in and custom.

No parameters required.

Returns: JSON array of response token objects with name, type, and enabled status.

Example prompt: “List all response tokens.”

Revision tools tools-revisions

Get the audit log

Tool: get_target_revisions

Get the audit log for a resource type.

Retrieves changes made to Target resources with optional filtering by author.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parameter Type Required Description
revision_resource_type string Yes Type of resource: activity, offer, or audience
modified_by string No Filter by user who made changes
limit integer No Maximum number of revisions to return
offset integer No Number of revisions to skip for pagination

Returns: Revision history with timestamps, users, and change descriptions.

Example prompt: “Show me the audit log for activity changes.”

Get revisions for a specific entity

Tool: get_target_entity_revisions

Get all revisions of a specific entity by ID.

table 0-row-4 1-row-4 2-row-4
Parameter Type Required Description
revision_resource_type string Yes Type of resource: activity, offer, or audience
entity_id integer Yes The unique identifier of the entity

Returns: JSON array of all revisions for the specified entity.

Example prompt: “Show me all changes made to activity 12345.”

Template tools tools-templates

List available templates

Tool: list_target_templates

List available MCP resources and templates for creating activities and offers.

No parameters required.

Returns: JSON object listing available templates and resources.

Example prompt: “What templates are available for creating activities?”

Tools summary tools-summary

Category
Count
Tools
Activity
4
list_target_activities, get_ab_activity, get_xt_activity, get_abt_activity
Offer
2
list_target_offers, get_target_offer
Audience
2
list_target_audiences, get_target_audience
Mbox
3
list_target_mboxes, get_target_mbox, list_target_mbox_profile_attributes
Property
1
list_target_properties
Reporting
6
get_ab_performance_report, get_ab_orders_report, get_xt_performance_report, get_xt_orders_report, get_activity_report_by_name, get_a4t_report
Preview
1
preview_activity
Response token
1
list_target_response_tokens
Revision
2
get_target_revisions, get_target_entity_revisions
Template
1
list_target_templates
Total
23
recommendation-more-help
target-help-main