@vitrion/zentria-mcp

Zentria MCP server — full Zentria public team API coverage for AI assistants via the Model Context Protocol.

Published as @vitrion/zentria-mcp.

This server uses the official public REST API at /api/public. Paths and request bodies match the OpenAPI docs; they are not invented.

Features

• 76 tools covering discovery, to-dos, sales (people, deals, notes, activities, organizations, pipelines, forms, submissions), customers, CRM, Speed to Lead, webhooks, members, settings, and integrations

• Team-bound Personal Access Token auth (Authorization: Bearer)

• Automatic rate-limit retry (429 + Retry-After)

• Stdio transport (Cursor, Claude Desktop, Claude Code)

• Logs only to stderr (stdio-safe)

Related MCP server: Salesforce MCP

Requirements

• Node.js >= 20

• A Zentria team API key (Teams → API keys) with the scopes you need

Environment variables

The client also sends Accept: application/json and User-Agent: @vitrion/zentria-mcp/<version>. The API key is never written to logs.

Install

npx -y @vitrion/zentria-mcp

Cursor

Add to your user config (~/.cursor/mcp.json) or project config (.cursor/mcp.json):

{
  "mcpServers": {
    "zentria": {
      "command": "npx",
      "args": ["-y", "@vitrion/zentria-mcp"],
      "env": {
        "ZENTRIA_API_KEY": "<team-pat>",
        "ZENTRIA_BASE_URL": "https://app.zentria.nl"
      }
    }
  }
}

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Use the same mcpServers block as Cursor.

Claude Code

claude mcp add zentria -- npx -y @vitrion/zentria-mcp

Set ZENTRIA_API_KEY in your shell environment or MCP host config.

For AI agents

• Call get-me first to learn the bound team, enabled modules, and token scopes.

• API keys are bound to one team — you cannot switch teams with headers.

• Use the narrowest scopes when minting keys (sales:read, sales:write, etc.).

• Public API docs: /api/public/docs

• PAT writes can emit webhooks — avoid update loops on the same event.

Tool groups

Development

git clone https://github.com/vitrionbv/zentria-mcp.git
cd zentria-mcp
npm install
npm run build
npm test
npm run dev

Inspector

npm run build
npm run inspector

Publishing

Releases go to npm with trusted publishing (OIDC). Push a v* tag to run .github/workflows/npm-publish.yml. The workflow uses id-token: write and does not use NODE_AUTH_TOKEN.

Configure the trusted publisher on npm: GitHub org vitrionbv, repo zentria-mcp, workflow npm-publish.yml.

License

MIT — see LICENSE.

Links

• npm: @vitrion/zentria-mcp

• GitHub: vitrionbv/zentria-mcp

• Zentria public API docs

• Zentria n8n community node