Skip to main content

Tool Groups

The Aprimo MCP Server exposes hundreds of tools. Rather than turning tools on one at a time, an admin chooses tool groups for each client registration. A group is a set of tools that supports one job, such as "Find & Discover Content" or "View Projects". Groups are collected into areas, such as "Find & read content" or "Plan work".

This is also how the Tool Reference is organized: one page per area, one section per group.

How tool groups work​

TermWhat it is
AreaAn admin-facing category that holds related groups. Selecting an area selects every group in it. There are 15 areas, under three domains: DAM, PM, and Spend.
GroupThe unit of access. A group holds the tools for one job. There are 66 groups.
NeedsThe other groups a group depends on. Enabling a group also enables everything it needs, so an agent that can edit asset metadata can also find and read the asset first.
Read-onlySome groups are marked read-only. They are meant for look-up access without the ability to change data.

An agent never sees a group. It sees the tools in the groups that are enabled on its registration.

Choose tool groups for a registration​

Tool groups are set on the client registration you create for your MCP client. See Create a Client Registration for the rest of the registration.

  1. Open the registration for your MCP client.
  2. Choose the areas or groups you want the client to use. Groups that your selection needs are selected for you.
  3. Save the registration.

A few rules apply:

  • Select at least one group. A registration for an MCP client cannot be saved with none.
  • Dependencies are enforced. A save that leaves out a group that another selected group needs is rejected.
  • Changes take a few minutes. Aprimo caches a registration's groups, so a change can take up to 5 minutes to reach a connected client. Reconnect your client after waiting.
  • You need System Administration access to change a registration's groups, and you can only change registrations in your own tenant.
Start small

Enable only the groups your agent needs. A shorter tool list is easier for an agent to reason over, and it limits what the agent can change.

What your agent sees​

The tool list your agent receives is built in three steps:

  1. Groups. The server starts with the tools in the groups enabled on the registration. A tool that appears in more than one enabled group is listed once.
  2. Tool availability. Some tools are registered but are not offered in any tool list while a known issue is being fixed. The Tool Reference labels these Not currently available.
  3. The user's own permissions. The server then hides tools the signed-in user's Aprimo rights rule out. Two users on the same registration can therefore see different tools. See the MCP Tool Permission Map.
Visibility is not authorization

A tool in the list can still return an authorization error if the user lacks rights to the record, task, or file. Every call runs as the signed-in user.

Errors​

When a call fails, the error code tells you which layer rejected it.

CodeMeaning
TOOL_DISABLEDThe tool exists, but its group is not enabled on this registration. Enable the group, or the group that contains it.
TOOL_NOT_FOUNDThe name does not match any tool.
TOOL_NOT_AUTHORIZEDAprimo refused the signed-in user.
TOOL_EXECUTION_FAILEDThe tool failed, including when an argument was missing or malformed.
TOOL_UNAVAILABLEA service the tool depends on failed.
TOOL_TIMEOUTThe call timed out.

Existing registrations​

Registrations created before tool groups were introduced, and never configured with groups, start with the same default set so existing agents keep a working tool list:

  • All eight groups in DAM: Find & read content.
  • Both groups in PM: PM lookups.

That set is read-oriented. Tools in other groups, such as the ones that edit metadata, search Activities, or search Projects, are not listed until an admin enables their groups. Registrations created after tool groups were introduced start with no groups, and you must choose at least one.

Group catalog​

Every group is listed below with its access level, the groups it needs, and its tool count. Each group name links to its tools in the Tool Reference.

DAM​

Find & read content​

GroupAccessNeedsTools
Find & Discover ContentRead-onlyNone18
View Asset Metadata & HistoryRead-onlyFind & Discover Content, Read the Content Model9
View Files & VersionsRead-onlyFind & Discover Content16
Get Previews, Thumbnails & RenditionsRead-onlyView Files & Versions16
Read the Content ModelRead-onlyNone20
View Processing, Check & Watermark ResultsCan change dataView Files & Versions12
Download & Order FilesCan change dataFind & Discover Content, View Files & Versions23
View Public LinksRead-onlyView Files & Versions4

Contribute & change content​

GroupAccessNeedsTools
Upload & Create ContentCan change dataFind & Discover Content, Read the Content Model9
Edit Asset MetadataCan change dataFind & Discover Content, View Asset Metadata & History, Read the Content Model10
Check Out, Check In & LockCan change dataFind & Discover Content, View Files & Versions, Upload & Create Content11
Delete RecordsCan change dataFind & Discover Content1
Annotate & Comment on ContentCan change dataView Files & Versions3
Organize Content into CollectionsCan change dataFind & Discover Content, Look Up DAM Users & Groups12
Manage Content SubscriptionsCan change dataFind & Discover Content, Look Up DAM Users & Groups5

Publish content​

GroupAccessNeedsTools
Publish Public LinksCan change dataView Public Links4

Configure the content model​

GroupAccessNeedsTools
Configure Custom Metadata FieldsCan change dataRead the Content Model10
Configure Content Types & File TypesCan change dataRead the Content Model6
Govern the Classification TaxonomyCan change dataFind & Discover Content, Look Up DAM Users & Groups9
Manage Languages & TranslationsCan change dataRead the Content Model12

Automate & process files​

GroupAccessNeedsTools
Automate Rules & Maintenance JobsCan change dataRead the Content Model, Find & Discover Content, Look Up DAM Users & Groups16
Configure Automated ChecksCan change dataRead the Content Model7
Configure Watermarks & Image OverlaysCan change dataFind & Discover Content, Look Up DAM Users & Groups10

Security & access​

GroupAccessNeedsTools
Look Up DAM Users & GroupsRead-onlyNone8
Set Permissions for Users, Groups & ContentCan change dataLook Up DAM Users & Groups, Find & Discover Content20
Manage Access ListsCan change dataLook Up DAM Users & Groups11
Configure Download Agreement PoliciesCan change dataLook Up DAM Users & Groups, Find & Discover Content, Read the Content Model9

System administration​

GroupAccessNeedsTools
Configure DAM System SettingsCan change dataNone13
Administer & Monitor the DAM SystemCan change dataNone15

PM​

PM lookups​

GroupAccessNeedsTools
Look Up PM Reference DataRead-onlyNone10
Look Up PM Users, Groups & RolesCan change dataNone12

Plan work​

GroupAccessNeedsTools
View ActivitiesRead-onlyLook Up PM Reference Data8
Edit ActivitiesCan change dataView Activities, Look Up PM Reference Data, Look Up PM Users, Groups & Roles9
View ProgramsRead-onlyView Activities3
Edit ProgramsCan change dataView Programs1
View ProposalsRead-onlyView Activities, View Programs5
Edit ProposalsCan change dataView Proposals, View Activities, Look Up PM Reference Data2
Content PlanningCan change dataView Activities, Look Up PM Users, Groups & Roles13
Calendar ManagementCan change dataView Activities, Look Up PM Users, Groups & Roles4
View ProjectsRead-onlyView Activities9
Manage a ProjectCan change dataView Projects, View Activities, Look Up PM Reference Data, Look Up PM Users, Groups & Roles8
View Work RequestsRead-onlyLook Up PM Reference Data, Look Up PM Users, Groups & Roles9

Task Management​

GroupAccessNeedsTools
View Task Details & AssignmentsRead-onlyLook Up PM Users, Groups & Roles14
Work My TasksCan change dataView Task Details & Assignments, Look Up PM Users, Groups & Roles12
Fill Out Task Checklists & Data Collection FormsCan change dataView Task Details & Assignments, Look Up PM Reference Data10
Attach Documents & Files to TasksCan change dataView Task Details & Assignments, Find & Discover Content17
Review & Approve DeliverablesCan change dataAttach Documents & Files to Tasks, Look Up PM Users, Groups & Roles22
Annotate PM DocumentsCan change dataManage Supporting Documents4
Manage Supporting DocumentsCan change dataView Projects, View Task Details & Assignments, Look Up PM Users, Groups & Roles, Find & Discover Content22
Collaborate in ChatboardsCan change dataLook Up PM Users, Groups & Roles14

Offer Manager​

GroupAccessNeedsTools
Segment Audiences (Activity Cells)Can change dataView Activities, Look Up PM Reference Data12
Define Treatments & OffersCan change dataSegment Audiences (Activity Cells), Look Up PM Reference Data20

Generic Objects​

GroupAccessNeedsTools
Generic Object: Alpha (activity-linked)Can change dataLook Up PM Reference Data, View Activities7
Generic Object: Bravo (project-linked)Can change dataLook Up PM Reference Data, View Projects7
Generic Object: CharlieCan change dataLook Up PM Reference Data6
Generic Object: DeltaCan change dataLook Up PM Reference Data6
Generic Object: EchoCan change dataLook Up PM Reference Data6

PM administration​

GroupAccessNeedsTools
Administer PM Users, Groups, Roles & Pick ListsCan change dataLook Up PM Users, Groups & Roles, Look Up PM Reference Data12

Spend​

Budget & forecast​

GroupAccessNeedsTools
Set Up Funding Accounts & HierarchiesCan change dataNone8
View BudgetsRead-onlyNone14
Plan Budget AllocationsCan change dataView Budgets, Set Up Funding Accounts & Hierarchies, View Activities, View Programs, Look Up PM Reference Data7
Forecast SpendCan change dataView Activities, View Programs, Look Up PM Reference Data8

Commit & pay​

GroupAccessNeedsTools
Manage SuppliersCan change dataNone6
Commit SpendCan change dataManage Suppliers, View Activities11
Process InvoicesCan change dataCommit Spend, Manage Suppliers12
Post Journal VouchersCan change dataSet Up Funding Accounts & Hierarchies11

Troubleshooting​

"Why can't my agent call this tool?"

  1. Find the tool's group in the Tool Reference and check that the group, and the groups it needs, are enabled on the registration.
  2. Wait up to 5 minutes after a change, then reconnect the client.
  3. Check the tool is not labelled Not currently available.
  4. Check the signed-in user's own rights. A tool the user cannot use may be hidden, or may return TOOL_NOT_AUTHORIZED when called.

The tool list is empty. The registration has no groups, or the server could not read the registration and returned no tools. Open the registration and confirm that groups are selected. If the list stays empty, contact Aprimo Support.