MCP Tool Permission Map
These are the permissions that make each MCP tool visible to your agent. Aprimo's MCP Server builds the tool list in two steps. First, the tool groups enabled on the client registration select which tools the client can use. Then the server tailors that list to each connected user: a tool appears in the agent's tools/list only when its group is enabled and the user holds the permission(s) mapped to it below. This keeps the advertised tool set focused on what the user can actually work with, and reduces the context an agent has to reason over.
The Group column shows each tool's tool group, so you can see which group an admin has to enable for the tool to appear.
Productivity Management (PM) and DAM are governed independently, and read differently:
- PM tools (below, under PM) use OR logic: holding any single one of the listed permissions is enough.
- DAM tools (below, under DAM) use AND logic: a tool that lists more than one permission requires all of them together. Most DAM tools list only one permission, so this distinction only matters for the handful explicitly marked "requires all of."
- Tools not listed here have no user-permission gate. Once their group is enabled, they are shown to every connected user — for both PM and DAM. Absence from this page means "always visible," not "hidden."
- The System Administration right surfaces almost everything on the PM side. It appears as an option on nearly every PM tool. The user- and group-administration tools are the exception — they require the Security Administrator right specifically (see Users, Groups & Roles).
- Permission names are what your admins see. PM permissions are the Aprimo functional rights granted per user; DAM permissions are the named checkboxes on a user's DAM Permissions tab in System Studio.
This map only controls whether a tool is shown to the agent — it does not grant access. Every tool call is still authorized per user by Aprimo at execution time. For many tools, holding the permission that surfaces the tool is necessary but not sufficient: the user must additionally be on the relevant access list, finance group, field group, or record to succeed. A visible tool can still return an authorization error when the agent calls it.
PM
Activities
Includes activity roles and the Activity-backed generic object.
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_activity | View Activities | Activity, View, Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
list_activities | View Activities | Activity, View, Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
search_activities | View Activities | Activity, View, Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
get_associated_activities | View Activities | Activity, View, Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
create_activity | Edit Activities | Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
update_activity | Edit Activities | Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
delete_activity | Edit Activities | Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
create_activity_milestone | Edit Activities | Activity, Edit, System Administration, Access |
list_activity_roles | View Activities | Activity, View, Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
get_activity_role | View Activities | Activity, View, Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
create_activity_role | Edit Activities | Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
update_activity_role | Edit Activities | Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
delete_activity_role | Edit Activities | Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
add_activity_role_members | Edit Activities | Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
remove_activity_role_member | Edit Activities | Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
get_generic_object_alpha | Generic Object: Alpha (activity-linked) | Activity, View, Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
list_generic_object_alpha_for_activity | Generic Object: Alpha (activity-linked) | Activity, View, Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
Activity Cells & Treatments
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_activity_cell | Segment Audiences (Activity Cells) | Activity, View, Activity, Edit, System Administration, Access |
list_activity_cells | Segment Audiences (Activity Cells) | Activity, View, Activity, Edit, System Administration, Access |
create_activity_cell | Segment Audiences (Activity Cells) | Activity, Edit, System Administration, Access |
update_activity_cell | Segment Audiences (Activity Cells) | Activity, Edit, System Administration, Access |
delete_activity_cell | Segment Audiences (Activity Cells) | Activity, Edit, System Administration, Access |
get_activity_cell_treatment | Segment Audiences (Activity Cells) | Activity, View, Activity, Edit, System Administration, Access |
list_activity_cell_treatments | Segment Audiences (Activity Cells) | Activity, View, Activity, Edit, System Administration, Access |
create_activity_cell_treatment | Segment Audiences (Activity Cells) | Activity, Edit, System Administration, Access |
update_activity_cell_treatment | Segment Audiences (Activity Cells) | Activity, Edit, System Administration, Access |
delete_activity_cell_treatment | Segment Audiences (Activity Cells) | Activity, Edit, System Administration, Access |
get_activity_treatment | Define Treatments & Offers | Activity, View, Activity, Edit, System Administration, Access |
create_activity_treatment | Define Treatments & Offers | Activity, Edit, System Administration, Access |
update_activity_treatment | Define Treatments & Offers | Activity, Edit, System Administration, Access |
delete_activity_treatment | Define Treatments & Offers | Activity, Edit, System Administration, Access |
list_activity_treatments | Define Treatments & Offers | Activity, View, Activity, Edit, Content Plan, Create and Edit Activities, System Administration, Access |
Treatments
Top-level treatments (distinct from the activity-scoped treatments above).
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_treatment | Define Treatments & Offers | Treatment, View, Treatment, Edit, System Administration, Access |
create_treatment | Define Treatments & Offers | Treatment, Edit, System Administration, Access |
update_treatment | Define Treatments & Offers | Treatment, Edit, System Administration, Access |
Projects & Review Tasks
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
list_projects | View Projects | Project, View, Task Portal, Access, Job Starter Portal, Access, Review Portal, Access, System Administration, Access |
list_projects_display | View Projects | Project, View, Task Portal, Access, Job Starter Portal, Access, Review Portal, Access, System Administration, Access |
search_projects | View Projects | Project, View, Task Portal, Access, Job Starter Portal, Access, Review Portal, Access, System Administration, Access |
get_project | View Projects | Project, View, Task Portal, Access, Job Starter Portal, Access, Review Portal, Access, System Administration, Access |
get_projects_for_activity | View Projects | Project, View, Task Portal, Access, Job Starter Portal, Access, Review Portal, Access, System Administration, Access |
list_projects_for_attachment | View Projects | Project, View, Task Portal, Access, Job Starter Portal, Access, Review Portal, Access, System Administration, Access |
get_project_dam_collection | View Projects | Project, View, Task Portal, Access, Job Starter Portal, Access, Review Portal, Access, System Administration, Access |
create_project | Manage a Project | Project, Edit, System Administration, Access |
update_project | Manage a Project | Project, Edit, System Administration, Access |
start_project | Manage a Project | Project, Edit, System Administration, Access |
pause_project | Manage a Project | Project, Edit, System Administration, Access |
cancel_project | Manage a Project | Project, Edit, System Administration, Access |
close_project | Manage a Project | Project, Edit, System Administration, Access |
update_review_task_begin_date | Review & Approve Deliverables | Project, Edit, System Administration, Access |
update_review_task_estimated_duration | Review & Approve Deliverables | Project, Edit, System Administration, Access |
update_review_task_end_date | Review & Approve Deliverables | Project, Edit, System Administration, Access |
Programs
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_program | View Programs | Program, View, System Administration, Access |
list_programs | View Programs | Program, View, System Administration, Access |
get_programs_for_activity | View Programs | Program, View, System Administration, Access |
update_program | Edit Programs | Program, Edit, System Administration, Access |
Suppliers
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
list_suppliers | Manage Suppliers | Supplier, View, System Administration, Access |
search_suppliers | Manage Suppliers | Supplier, View, System Administration, Access |
get_supplier | Manage Suppliers | Supplier, View, System Administration, Access |
update_supplier | Manage Suppliers | Supplier, Edit, System Administration, Access |
Offers
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
list_offers | Define Treatments & Offers | Offers, View, Offers, Edit, System Administration, Access |
get_offer | Define Treatments & Offers | Offers, View, Offers, Edit, System Administration, Access |
create_offer | Define Treatments & Offers | Offers, View, Offers, Edit, System Administration, Access |
update_offer | Define Treatments & Offers | Offers, View, Offers, Edit, System Administration, Access |
get_offer_treatments | Define Treatments & Offers | Offers, View, Offers, Edit, System Administration, Access |
Proposals
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_activity_proposal | View Proposals | Proposal, View, System Administration, Access |
search_activity_proposals | View Proposals | Proposal, View, Proposal, Edit, System Administration, Access |
get_activity_proposal_forecasts | Forecast Spend | Proposal, View, System Administration, Access |
get_program_proposal | View Proposals | Program, View, Program, Edit, Proposal, View, System Administration, Access |
search_program_proposals | View Proposals | Proposal, View, Proposal, Edit, System Administration, Access |
Content Plans
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
update_content_plan | Content Planning | Content Plan, Edit, Integration API, Access, System Administration, Access |
unlink_content_plan_collection | Content Planning | Content Plan, Edit, Integration API, Access, System Administration, Access |
create_content_plan_collection | Content Planning | Content Plan, Edit, System Administration, Access |
update_content_plan_collection | Content Planning | Content Plan, Edit, System Administration, Access |
share_content_plan | Content Planning | Content Plan, Edit, System Administration, Access |
remove_content_plan_activity | Content Planning | Content Plan, Edit, System Administration, Access |
delete_content_plan | Content Planning | Content Plan, Edit, System Administration, Access |
Work Requests
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
list_work_requests | View Work Requests | Job Starter Portal, Access, System Administration, Access |
search_work_requests | View Work Requests | Job Starter Portal, Access, System Administration, Access |
get_work_request | View Work Requests | Job Starter Portal, Access, System Administration, Access |
list_work_request_reviews | View Work Requests | Work Request, View, Job Starter Portal, Access, System Administration, Access |
Invoices
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_invoice | Process Invoices | Invoice, View, System Administration, Access |
create_invoice | Process Invoices | Invoice, Edit, Invoice, Mass Entry, System Administration, Access |
update_invoice | Process Invoices | Invoice, Edit, Invoice, Mass Entry, System Administration, Access |
delete_invoice | Process Invoices | Invoice, Edit, Invoice, Mass Entry, System Administration, Access |
retrieve_invoice | Process Invoices | Invoice, Edit, Invoice, Mass Entry, System Administration, Access |
submit_invoice | Process Invoices | Invoice, Edit, Invoice, Mass Entry, System Administration, Access |
cancel_invoice | Process Invoices | Invoice, Edit, Invoice, Mass Entry, System Administration, Access |
mark_invoice_sent | Process Invoices | System Administration, Access |
Commitments
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
create_commitment | Commit Spend | Commitments, Edit, Commitment, Mass Entry, System Administration, Access |
update_commitment | Commit Spend | Commitments, Edit, Commitment, Mass Entry, System Administration, Access |
delete_commitment | Commit Spend | Commitments, Edit, Commitment, Mass Entry, System Administration, Access |
retrieve_commitment | Commit Spend | Commitments, Edit, Commitment, Mass Entry, System Administration, Access |
submit_commitment | Commit Spend | Commitments, Edit, Commitment, Mass Entry, System Administration, Access |
cancel_commitment | Commit Spend | Commitments, Edit, Commitment, Mass Entry, System Administration, Access |
Financial Hierarchies & Funding Accounts
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
create_financial_hierarchy | Set Up Funding Accounts & Hierarchies | Financial, Finance Group Administrator, Financial, General Administrator, System Administration, Access |
update_financial_hierarchy | Set Up Funding Accounts & Hierarchies | Financial, Finance Group Administrator, Financial, General Administrator, System Administration, Access |
get_financial_hierarchy | Set Up Funding Accounts & Hierarchies | Financial Hierarchies, View, Financial, Finance Group Administrator, Financial, General Administrator, System Administration, Access |
get_financial_hierarchy_node | Set Up Funding Accounts & Hierarchies | Financial Hierarchies, View, Financial, Finance Group Administrator, Financial, General Administrator, System Administration, Access |
get_funding_account | Set Up Funding Accounts & Hierarchies | Financial, Finance Group Administrator, Financial, General Administrator, System Administration, Access |
get_funding_account_summary | Set Up Funding Accounts & Hierarchies | Financial, Finance Group Administrator, Financial, General Administrator, System Administration, Access |
Journal Vouchers
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
list_journal_vouchers | Post Journal Vouchers | Journal Vouchers, View, System Administration, Access |
search_journal_vouchers | Post Journal Vouchers | Journal Vouchers, View, System Administration, Access |
get_journal_voucher | Post Journal Vouchers | Journal Vouchers, View, System Administration, Access |
create_journal_voucher | Post Journal Vouchers | Journal Vouchers, Edit, System Administration, Access |
update_journal_voucher | Post Journal Vouchers | Journal Vouchers, Edit, System Administration, Access |
submit_journal_voucher | Post Journal Vouchers | Journal Vouchers, Edit, System Administration, Access |
mark_journal_voucher_sent | Post Journal Vouchers | System Administration, Access |
reject_journal_voucher | Post Journal Vouchers | System Administration, Access |
Users, Groups & Roles
The group and user administration tools require the Security Administrator right. Unlike most tools on this page, the general System Administration right does not make them visible on its own. The user-role tools accept either.
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_pm_group | Look Up PM Users, Groups & Roles | Security Administration |
get_pm_group_membership | Look Up PM Users, Groups & Roles | Security Administration |
list_pm_groups | Look Up PM Users, Groups & Roles | Security Administration |
create_pm_group | Administer PM Users, Groups, Roles & Pick Lists | Security Administration |
update_pm_group | Administer PM Users, Groups, Roles & Pick Lists | Security Administration |
delete_pm_group | Administer PM Users, Groups, Roles & Pick Lists | Security Administration |
search_pm_users | Look Up PM Users, Groups & Roles | Security Administration |
create_pm_user | Administer PM Users, Groups, Roles & Pick Lists | Security Administration |
update_pm_user | Administer PM Users, Groups, Roles & Pick Lists | Security Administration |
delete_pm_user | Administer PM Users, Groups, Roles & Pick Lists | Security Administration |
reset_user_pin | Administer PM Users, Groups, Roles & Pick Lists | Security Administration |
update_my_region_preferences | Look Up PM Users, Groups & Roles | Security Administration |
list_domain_rights | Look Up PM Users, Groups & Roles | Security Administration |
list_user_roles | Look Up PM Users, Groups & Roles | Security Administration, System Administration, Access |
update_user_role | Administer PM Users, Groups, Roles & Pick Lists | Security Administration, System Administration, Access |
delete_user_role | Administer PM Users, Groups, Roles & Pick Lists | Security Administration, System Administration, Access |
Teams
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_team | View Task Details & Assignments | Teams, View, System Administration, Access |
list_teams | View Task Details & Assignments | Teams, View, System Administration, Access |
Digital Assets & Attachments
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_digital_asset | Manage Supporting Documents | Digital Assets, View, System Administration, Access |
update_attachment_version | Manage Supporting Documents | System Administration, Access |
Annotations
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
get_dam_record_reference_documents | Annotate PM Documents | System Administration, Access |
create_public_xfdf_annotation | Annotate PM Documents | Integration API, Access, System Administration, Access |
get_public_xfdf_annotations | Annotate PM Documents | Integration API, Access, System Administration, Access |
delete_public_xfdf_annotation | Annotate PM Documents | Integration API, Access, System Administration, Access |
Other (PM)
| Tool | Group | Visible if the user holds any one of |
|---|---|---|
update_calendar_activity_type_colors | Calendar Management | System Administration, Access |
delete_chatboard | Collaborate in Chatboards | Chat Board, Delete, System Administration, Access |
update_pick_list_options | Administer PM Users, Groups, Roles & Pick Lists | System Tools, Extended Attributes Edit, System Administration, Access |
DAM
DAM tools are gated on the permissions found on a user's DAM Permissions tab in System Studio. Almost every tool below is gated on a single permission; where a tool needs more than one, the table says so explicitly and the user must hold all of them together, not just one.
Permissions & Access Lists
| Tool | Group | Visible if the user holds |
|---|---|---|
preview_create_access_list | Manage Access Lists | Can manage access lists |
apply_create_access_list | Manage Access Lists | Can manage access lists |
preview_access_list_members_by_id | Manage Access Lists | Can manage access lists |
apply_access_list_members_by_id | Manage Access Lists | Can manage access lists |
preview_access_list_members_by_key | Manage Access Lists | Can manage access lists |
apply_access_list_members_by_key | Manage Access Lists | Can manage access lists |
delete_access_list | Manage Access Lists | Can manage access lists |
delete_access_list_by_key | Manage Access Lists | Can manage access lists |
preview_permission_definition | Set Permissions for Users, Groups & Content | Change setting definition |
apply_permission_definition | Set Permissions for Users, Groups & Content | Change setting definition |
Field Definitions
Manage profile and fields of field group isn't one tenant-wide checkbox — it's granted separately for each field group, the same way a user is granted access to individual access lists. A user editing a field definition needs that permission for every field group the definition belongs to.
| Tool | Group | Visible if the user holds |
|---|---|---|
create_field_definition | Configure Custom Metadata Fields | Create field definition |
delete_field_definition | Configure Custom Metadata Fields | Delete field definition |
update_field_definition | Configure Custom Metadata Fields | Manage profile and fields of field group |
create_field_group | Configure Custom Metadata Fields | Create field group |
update_field_group | Configure Custom Metadata Fields | Manage profile and fields of field group |
delete_field_group | Configure Custom Metadata Fields | Delete field group |
list_field_population_log_summary | Configure Custom Metadata Fields | Ability to read the application log |
get_field_population_log_recent | Configure Custom Metadata Fields | Ability to read the application log |
File Types
| Tool | Group | Visible if the user holds |
|---|---|---|
create_file_type | Configure Content Types & File Types | Create file type |
update_file_type | Configure Content Types & File Types | Change file type |
delete_file_type | Configure Content Types & File Types | Delete file type |
Languages & Translations
| Tool | Group | Visible if the user holds |
|---|---|---|
create_language | Manage Languages & Translations | Create language |
update_language | Manage Languages & Translations | Change language |
delete_language | Manage Languages & Translations | Delete language |
update_language_synonyms | Manage Languages & Translations | Change language |
create_translation | Manage Languages & Translations | Create translation |
update_translation | Manage Languages & Translations | Change translation |
delete_translation | Manage Languages & Translations | Delete translation |
Rules
| Tool | Group | Visible if the user holds |
|---|---|---|
create_rule | Automate Rules & Maintenance Jobs | Create rules |
update_rule | Automate Rules & Maintenance Jobs | Change Rules |
delete_rule | Automate Rules & Maintenance Jobs | Delete Rule |
Watermarks
| Tool | Group | Visible if the user holds |
|---|---|---|
create_watermark | Configure Watermarks & Image Overlays | Create watermark |
update_watermark | Configure Watermarks & Image Overlays | Change watermarks |
delete_watermark | Configure Watermarks & Image Overlays | Delete watermark |
Image Overlays & Annotations
| Tool | Group | Visible if the user holds |
|---|---|---|
create_image_overlay | Configure Watermarks & Image Overlays | Create watermark |
Settings
| Tool | Group | Visible if the user holds |
|---|---|---|
create_setting_category | Configure DAM System Settings | Create setting category |
update_setting_category | Configure DAM System Settings | Change setting category |
delete_setting_category | Configure DAM System Settings | Delete setting category |
create_setting_definition | Configure DAM System Settings | Create setting definition |
update_setting_definition | Configure DAM System Settings | Change setting definition |
delete_setting_definition | Configure DAM System Settings | Delete setting definition |
Downloads & Public Links
| Tool | Group | Visible if the user holds |
|---|---|---|
create_public_link | Publish Public Links | Can configure the public urls of content items |
update_public_link | Publish Public Links | Can configure the public urls of content items |
delete_public_link | Publish Public Links | Can configure the public urls of content items |
submit_public_link | Publish Public Links | Submit maintenance jobs and Can configure the public urls of content items |
create_download_agreement | Configure Download Agreement Policies | Change system settings |
update_download_agreement | Configure Download Agreement Policies | Change system settings |
delete_download_agreement | Configure Download Agreement Policies | Change system settings |
accept_download_link_agreement | Download & Order Files | Submit maintenance jobs |
get_download_link | Download & Order Files | View maintenance jobs |
list_download_link_targets | Download & Order Files | View maintenance jobs |
list_download_links | Download & Order Files | View maintenance jobs |
submit_shared_download_link | Download & Order Files | Submit maintenance jobs |
check_shared_download_link | Download & Order Files | View maintenance jobs |
check_public_link | View Public Links | View maintenance jobs |
System Administration & Maintenance
| Tool | Group | Visible if the user holds |
|---|---|---|
create_maintenance_job | Automate Rules & Maintenance Jobs | Submit maintenance jobs |
check_maintenance_job | Automate Rules & Maintenance Jobs | View maintenance jobs |
list_maintenance_jobs | Automate Rules & Maintenance Jobs | View maintenance jobs |
get_maintenance_job_target | Automate Rules & Maintenance Jobs | View maintenance jobs |
list_maintenance_job_targets | Automate Rules & Maintenance Jobs | View maintenance jobs |
Orders
| Tool | Group | Visible if the user holds |
|---|---|---|
get_order_target | Download & Order Files | View maintenance jobs |
list_order_targets | Download & Order Files | View maintenance jobs |
list_orders | Download & Order Files | View maintenance jobs |
update_order | Download & Order Files | View maintenance jobs |
Records
| Tool | Group | Visible if the user holds |
|---|---|---|
check_download_order_status | Download & Order Files | View maintenance jobs |
get_record_download_url | Download & Order Files | Submit maintenance jobs and View maintenance jobs |
Record Lifecycle & Edit Sessions
| Tool | Group | Visible if the user holds |
|---|---|---|
apply_and_save_record_edit | Upload & Create Content | Create record |
execute_record_checkout | Check Out, Check In & Lock | View maintenance jobs and Submit maintenance jobs |
get_record_checkout_status | Check Out, Check In & Lock | View maintenance jobs |
Files & File Versions
| Tool | Group | Visible if the user holds |
|---|---|---|
check_out_file | Check Out, Check In & Lock | View maintenance jobs and Submit maintenance jobs |
update_file_process_action | View Processing, Check & Watermark Results | Change system settings |
list_file_version_process_action_log | View Processing, Check & Watermark Results | Can view the audit trail of content items |
Upload
| Tool | Group | Visible if the user holds |
|---|---|---|
create_record_with_file | Upload & Create Content | Create record |
Related
- Aprimo MCP Server — configuration, connection details, and the most common tools
- Tool Groups — how an admin chooses which tools a client can use
- Tool Reference — every tool, organized by area and group
- The Invocation Pattern — when and how to call Aprimo from an orchestration platform
- Authorization — how per-user authorization is enforced across Aprimo's APIs