aditum-mcp

An MCP server for Aditum, the industrial data platform. Your AI assistant (Claude, GitHub Copilot, Cursor, ...) can read your Aditum workspace:

Read only: nothing can be changed through it.

Set up

1. In Aditum, open Settings > API tokens, create a token and tick Read only (a token that can make changes is refused). It is shown once.
2. Add the server to your assistant, for example Claude Code:

claude mcp add aditum --env ADITUM_TOKEN=adp_... --env ADITUM_URL=https://app.aditumdata.com -- uvx aditum-mcp

or in a JSON config (Claude Desktop, VS Code, Cursor):

{
  "mcpServers": {
    "aditum": {
      "command": "uvx",
      "args": ["aditum-mcp"],
      "env": { "ADITUM_TOKEN": "adp_...", "ADITUM_URL": "https://app.aditumdata.com" }
    }
  }
}

ADITUM_URL is your workspace's https:// address (a dedicated workspace has its own). The token works only there, is never sent over plain http (except to localhost) and never follows a redirect.

What your assistant sees

The token acts as you: your workspace, your role and access rules, your plan's read limits (a query counts as query units). Aditum decides what each answer holds, by your organisation's AI data policy: by default (metadata_only) names, types, counts and column statistics, never row values; with samples, at most 5 rows per answer. Passwords and keys are never included. Every answer is marked as data from your systems, so a tag or asset name can't instruct the assistant.

Python 3.9+, no dependencies. An npm package with the same behaviour: npx aditum-mcp.