Get appointment statistics

Reads Admin > Statistiques RDV for a period: bookings, online share, new clients, no-shows, per service and per staff member.

MCP tool planity_read → get_appointment_stats

read

Returns the figures of the tabs Indicateurs clés, Prestations, Collaborateurs, RDV and RDV pas venus. All figures come from the appointments recorded in the agenda. estimated_revenue is Planity's estimate from bookings, not takings from the cash register.

Parameters

Parameters: get_appointment_stats
NameTypeDescription
date_from string required string First day, YYYY-MM-DD.
date_to string required string Last day, YYYY-MM-DD, included.
compare_previous boolean boolean Also return the previous period of the same length, as the compare option does. Default false.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "planity_read",
    "arguments": {
      "operation": "get_appointment_stats",
      "arguments": {
        "date_from": "2026-10-12",
        "date_to": "2026-10-18",
        "compare_previous": true
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "date_from": "2026-10-12",
    "date_to": "2026-10-18",
    "appointments": 154,
    "online": 96,
    "in_salon": 58,
    "online_rate_percent": 62.3,
    "new_clients": 21,
    "no_shows": 3,
    "estimated_revenue": 6120,
    "by_service": [
      {
        "service": "Coupe homme",
        "appointments": 55
      },
      {
        "service": "Coupe femme",
        "appointments": 41
      },
      {
        "service": "Brushing",
        "appointments": 35
      },
      {
        "service": "Couleur",
        "appointments": 23
      }
    ],
    "by_staff": [
      {
        "staff": "Amélie",
        "appointments": 62
      },
      {
        "staff": "Lucas",
        "appointments": 51
      },
      {
        "staff": "Inès",
        "appointments": 41
      }
    ],
    "previous": {
      "date_from": "2026-10-05",
      "date_to": "2026-10-11",
      "appointments": 141,
      "online": 83,
      "in_salon": 58
    }
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.