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.
An 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.
Group
The unit of access. A group holds the tools for one job. There are 66 groups.
Needs
The 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-only
Some 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.
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.
Open the registration for your MCP client.
Choose the areas or groups you want the client to use. Groups that your selection needs are selected for you.
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.
The tool list your agent receives is built in three steps:
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.
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.
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.
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.
Find the tool's group in the Tool Reference and check that the group, and the groups it needs, are enabled on the registration.
Wait up to 5 minutes after a change, then reconnect the client.
Check the tool is not labelled Not currently available.
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.