@transcend-io/mcp-server-dsr

Alpha — this package is under active development and has not yet been published to npm. APIs may change without notice.

Transcend MCP Server for data subject requests (DSR). Provides tools for submitting, tracking, and responding to privacy requests such as access, erasure, and opt-out.

Requires Node.js ≥ 22.12 (see engines in package.json).

For local runs from this repository, copy secret.env.example to secret.env at the repo root (gitignored) and set your API key (see Run from the monorepo).

Install

When the package is available on npm, install the CLI globally:

npm install -g @transcend-io/mcp-server-dsr

Until then, run from a checkout of this repository (see Run from the monorepo below).

Usage

# With TRANSCEND_API_KEY in the environment; from the monorepo use secret.env (see Run from the monorepo)
TRANSCEND_API_KEY=your-api-key transcend-mcp-dsr

The process speaks MCP over stdio and is meant to be launched by an MCP client (for example Cursor or Claude Desktop), not used as an interactive shell.

MCP client configuration

npx runs the package’s transcend-mcp-dsr binary (see bin in package.json).

{
  "mcpServers": {
    "transcend-dsr": {
      "command": "npx",
      "args": ["-y", "@transcend-io/mcp-server-dsr"],
      "env": {
        "TRANSCEND_API_KEY": "your-api-key"
      }
    }
  }
}

When developing in this repository, reuse the same variable names from root secret.env in the env block, or use your client’s env-file support if it has one.

Run from the monorepo

1. Credentials — From the repository root, copy secret.env.example to secret.env and set TRANSCEND_API_KEY (and optional URL overrides).

2. Build and run — node ./dist/cli.mjs matches the transcend-mcp-dsr bin (use node because pnpm exec transcend-mcp-dsr may not resolve this package’s own binary in a pnpm workspace):

# from the repository root
pnpm exec turbo run build --filter="@transcend-io/mcp-server-dsr..."
set -a && source ./secret.env && set +a
pnpm -F @transcend-io/mcp-server-dsr exec node ./dist/cli.mjs

Alternative: ./scripts/mcp-run.sh ./packages/mcp/mcp-server-dsr/dist/cli.mjs (sources secret.env when present; run after build).

See CONTRIBUTING.md for workspace layout and pnpm --filter workflows.

Environment variables

| Variable | Required | Default | Description | | ------------------- | -------- | ------------------------------------------ | -------------------------------------------------- | | TRANSCEND_API_KEY | Yes | — | Transcend API key | | TRANSCEND_API_URL | No | https://api.transcend.io | GraphQL backend API URL (matches CLI convention) | | SOMBRA_URL | No | https://multi-tenant.sombra.transcend.io | Sombra REST API URL (matches CLI / SDK convention) |

Monorepo: keep these in root secret.env (from secret.env.example); see Run from the monorepo.

Tools

• dsr_list — List data subject requests
• dsr_get_details — Get request details
• dsr_submit — Submit a new DSR
• dsr_employee_submit — Submit an employee DSR
• dsr_cancel — Cancel a request
• dsr_respond_access — Respond to an access request
• dsr_respond_erasure — Respond to an erasure request
• dsr_poll_status — Poll request status
• dsr_analyze — Analyze DSR data
• dsr_download_keys — Download encryption keys
• dsr_enrich_identifiers — Enrich request identifiers
• dsr_list_identifiers — List identifier types

Related packages

Also available as part of the unified @transcend-io/mcp which includes all domains. See the root README for the full list.