Back to setup guide

Public API & MCP

Read-only access to your organization metrics, reviews, and subscription events. Authenticate with an organization API key created in Settings → Developer.

Authentication

Send your Nicodesk API key as a Bearer token. Cookie sessions are not accepted on /api/v1.

Authorization: Bearer nd_<prefix>_<secret>

Create and revoke keys in Settings → Developer.

Endpoints

  • GET https://app.nicodesk.com/api/v1/me

    Smoke-test identity: organization id, name, and scopes.

  • GET https://app.nicodesk.com/api/v1/metrics?range=30D&groupBy=day

    Same query params as the dashboard metrics API: range or from/to, groupBy, compare, force.

  • GET https://app.nicodesk.com/api/v1/reviews?limit=50&platform=ios

    Up to 200 most recent reviews. Filters: platform, connectionId, bundleId, unanswered=1, maxRating.

  • GET https://app.nicodesk.com/api/v1/events?limit=50

    Up to 200 most recent subscription events. Filters: platform, connectionId, bundleId.

Example

curl -sS \
  -H "Authorization: Bearer nd_YOUR_KEY" \
  "https://app.nicodesk.com/api/v1/me"

MCP

The hosted MCP server exposes the same read tools. Pass the API key in the Authorization header.

{
  "mcpServers": {
    "nicodesk": {
      "url": "https://app.nicodesk.com/api/mcp",
      "headers": {
        "Authorization": "Bearer nd_YOUR_KEY"
      }
    }
  }
}

Limits

Soft rate limit: about 120 requests per minute per API key (best-effort on serverless). Reviews and events are capped at 200 rows per request.