Aprimo DAM API MCP Server

A Model Context Protocol server that exposes read tools for the Aprimo DAM REST API. Designed for deployment to Azure via Docker.

Tools

Related MCP server: MCP Microsoft Graph Server

Prerequisites

1. An Aprimo tenant with DAM enabled

2. An OAuth 2.0 Client Credentials registration in Aprimo Administration → Integration → Registrations

   • Flow type: Client Credentials

   • Scope: api

   • Assign an integration user with appropriate DAM read permissions

Configuration

Copy .env.example to .env and fill in your credentials:

cp .env.example .env

Local development

npm install
npm run dev

Test with the MCP Inspector:

npx @modelcontextprotocol/inspector
# Connect to http://localhost:3000/mcp (Streamable HTTP)

Connect in Claude

claude mcp add --transport http aprimo-dam http://localhost:3000/mcp

For Claude Desktop / Claude.ai, add a custom connector pointing to your deployed URL.

Client setup (Claude, Cursor, other LLMs): see docs/client-configuration.md — uses mcp-remote with X-Aprimo-* headers.

Docker

docker build -t aprimo-dam-api-mcp .
docker run -p 3000:3000 \
  -e APRIMO_TENANT=your-tenant \
  -e APRIMO_CLIENT_ID=your-client-id \
  -e APRIMO_CLIENT_SECRET=your-client-secret \
  aprimo-dam-api-mcp

Azure deployment

Manual Web App (Portal): see docs/azure-webapp-manual.md

Automated Container Apps: see docs/azure-deployment.md

API reference

Aprimo uses Select Headers to control which sub-resources are embedded in responses:

• select-record: fields — embed field values

• select-record: files,masterfile — embed file collections

• select-fileversion: renditions — embed renditions on file versions

See the Aprimo DAM REST API docs for full details.

License

MIT