personaleasy-mcp-server

MCP server for the PersonalEasy API | EasyDental Cloud | DentalKids.

Tools

All tools are read-only (readOnlyHint: true).

Related MCP server: open-dental-mcp

Installation

npm install
npm run build

Credentials

Credentials are never kept in the code. Set them via environment variables:

• PERSONALEASY_API_KEY — the api-key (header x-api-key)

• PERSONALEASY_CLIENT_ID — the client ID

• PERSONALEASY_BASE_URL — optional, defaults to https://prsrb.onrender.com/v1/rpc

For local testing, copy .env.example to .env and fill it in. The .env file is in .gitignore — do not version it or share it.

Configuration in Claude Code

claude mcp add personaleasy --env PERSONALEASY_API_KEY=SUA_KEY --env PERSONALEASY_CLIENT_ID=SEU_CLIENT_ID -- node D:/MCPS/personaleasy-mcp-server/dist/index.js

Configuration in Claude Desktop

In claude_desktop_config.json:

{
  "mcpServers": {
    "personaleasy": {
      "command": "node",
      "args": ["D:/MCPS/personaleasy-mcp-server/dist/index.js"],
      "env": {
        "PERSONALEASY_API_KEY": "SUA_KEY",
        "PERSONALEASY_CLIENT_ID": "SEU_CLIENT_ID"
      }
    }
  }
}

Deploy on Easypanel (Docker)

The project has two execution modes:

• stdio (dist/index.js) — local use (Claude Code / Claude Desktop)

• HTTP (dist/http.js) — remote use; this is the mode used by the Dockerfile

On Easypanel, create an App service pointing to this repository (build via Dockerfile) and configure the environment variables:

Expose port 3000 on the service. Endpoints:

• POST /mcp — MCP endpoint (Streamable HTTP, stateless)

• GET /health — healthcheck

Production instance

• Base URL: https://dk-projetos-mcps.nv8gf3.easypanel.host

• Healthcheck: GET https://dk-projetos-mcps.nv8gf3.easypanel.host/health → {"status":"ok"}

• MCP Endpoint: POST https://dk-projetos-mcps.nv8gf3.easypanel.host/mcp

To connect an MCP client to this instance:

claude mcp add --transport http personaleasy https://dk-projetos-mcps.nv8gf3.easypanel.host/mcp --header "Authorization: Bearer SEU_MCP_AUTH_TOKEN"

Replace SEU_MCP_AUTH_TOKEN with the value set in the MCP_AUTH_TOKEN variable of the Easypanel service.

Important: without MCP_AUTH_TOKEN configured in the service, anyone with this URL can query the clinic's data. Make sure the variable is set in production.

Underlying API

All calls go to a single RPC endpoint:

POST {BASE_URL}
Headers: x-api-key
Body: { "clientId": "...", "method": "RPCGet...", "params": { ... } }

Methods used: RPCGetAgendamentos, RPCGetKPIPrd, RPCGetPrestadorCPF, RPCGetUnidadeAtendimento.