StaffSavvy MCP by usefulapi

Read shifts, time entries, absences, staff accounts, venues and groups in StaffSavvy.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
84%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,474Tokens (tool definitions)
~1.0 KBTypical response size
Moderate attention impact (1.15% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "staffsavvy": {
      "url": "https://staffsavvy.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://staffsavvy.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (9)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢staffsavvy_get_info

Return the StaffSavvy software version and API version for this instance. A good first call to check the connection. API: GET /api/v1/info.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢staffsavvy_list_shifts(event, filters)

List shifts on the rota: start and end times, the account, group, venue and task. Filter by event or by field, e.g. start=gte:2026-01-01. API: GET /api/v1/shifts.

Input Schema

{
  "type": "object",
  "properties": {
    "event": {
      "description": "Optional event id filter.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "filters": {
      "description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 200
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢staffsavvy_get_shift(shift_id)

Return one shift by its numeric id. API: GET /api/v1/shifts/{shiftid}.

Input Schema

{
  "type": "object",
  "properties": {
    "shift_id": {
      "type": "string",
      "pattern": "^\\d{1,18}$",
      "description": "Numeric id."
    }
  },
  "required": [
    "shift_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢staffsavvy_list_time_entries(event, filters)

List recorded time entries (worked hours): start, end, account, group, venue and pay element. Filter by event or by field. API: GET /api/v1/time-entries.

Input Schema

{
  "type": "object",
  "properties": {
    "event": {
      "description": "Optional event id filter.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "filters": {
      "description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 200
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢staffsavvy_list_absences(filters)

List absence periods (holiday, sickness and other absences) with their dates and types. Filter by field. API: GET /api/v1/absences.

Input Schema

{
  "type": "object",
  "properties": {
    "filters": {
      "description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 200
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢staffsavvy_list_accounts(filters)

List staff accounts with names, contact details and levels. This returns personal data about staff. API: GET /api/v1/accounts.

Input Schema

{
  "type": "object",
  "properties": {
    "filters": {
      "description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 200
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢staffsavvy_list_venues(filters)

List the venues (sites or locations) set up in StaffSavvy. API: GET /api/v1/venues.

Input Schema

{
  "type": "object",
  "properties": {
    "filters": {
      "description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 200
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢staffsavvy_list_groups(filters)

List the groups (teams or departments) set up in StaffSavvy. API: GET /api/v1/groups.

Input Schema

{
  "type": "object",
  "properties": {
    "filters": {
      "description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 200
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢staffsavvy_list_absence_types(filters)

List the absence types set up in StaffSavvy, e.g. holiday or sickness. API: GET /api/v1/absence-types.

Input Schema

{
  "type": "object",
  "properties": {
    "filters": {
      "description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 200
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded9 tools