Rosterfy MCP by usefulapi
Read people, events, training and rewards; assign and remove people on shifts in Rosterfy.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Befunde (6)
- HIGHTool poisoning patterns detected
- LOWTool 'rosterfy_list_shift_assignments' name length outside 3-30 rangein rosterfy_list_shift_assignments
- LOWTool 'rosterfy_list_training_assignments' name length outside 3-30 rangein rosterfy_list_training_assignments
- LOWTool 'rosterfy_list_certificate_holders' name length outside 3-30 rangein rosterfy_list_certificate_holders
- LOWTool 'rosterfy_remove_user_from_shift' name length outside 3-30 rangein rosterfy_remove_user_from_shift
- LOWTool description contains role marker that could confuse chat modelsin rosterfy_get_current_user
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~3,902Tokens (Tool-Definitionen)
~2.2 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (3.05% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"rosterfy": {
"url": "https://rosterfy.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://rosterfy.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (15)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢rosterfy_get_current_user
Return the signed-in integration user: their profile, what they may do, and their user type. A quick check that the connection works. Rosterfy: GET /api/v2/user/me.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_list_users(page, per_page, sort_by, sort_order, filter)
List the people on the account, one page at a time, with their contact details and custom attributes. Use filter to find someone, for example attr name with operator like. Rosterfy: GET /api/v2/user.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page of results, from 1. Default 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Records per page, 1 to 100. Default 25.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"sort_by": {
"description": "Attribute to sort on, for example id. Sorting is not applied unless set.",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sort_order": {
"description": "Sort direction. Default asc.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"filter": {
"description": "Filter conditions. Each item is {attr, operator, value}. The filterable attributes differ per resource.",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"attr": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Attribute code to filter on."
},
"operator": {
"type": "string",
"minLength": 1,
"maxLength": 12,
"description": "Operator, for example = , > , < or like."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
],
"description": "Value to compare with."
}
},
"required": [
"attr",
"operator",
"value"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_get_user(user_id)
Return one person's full record, with their subscription and verification state. Rosterfy: GET /api/v2/user/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The user id."
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_list_events(page, per_page, sort_by, sort_order, filter)
List the events on the account, one page at a time. An event holds shifts; each shift has statuses that rosterfy_assign_user_to_shift needs. Rosterfy: GET /api/v2/event.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page of results, from 1. Default 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Records per page, 1 to 100. Default 25.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"sort_by": {
"description": "Attribute to sort on, for example id. Sorting is not applied unless set.",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sort_order": {
"description": "Sort direction. Default asc.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"filter": {
"description": "Filter conditions. Each item is {attr, operator, value}. The filterable attributes differ per resource.",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"attr": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Attribute code to filter on."
},
"operator": {
"type": "string",
"minLength": 1,
"maxLength": 12,
"description": "Operator, for example = , > , < or like."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
],
"description": "Value to compare with."
}
},
"required": [
"attr",
"operator",
"value"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_get_event(event_id)
Return one event: when and where it runs, who may see it, and the shift status defaults each shift inherits. Rosterfy: GET /api/v2/event/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The event id."
}
},
"required": [
"event_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_list_shift_assignments(event_id, shift_id, page, per_page, sort_by, ...)
List the people on one shift, with their status and check-in times, one page at a time. Rosterfy: GET /api/v2/event/{event_id}/shift/{shift_id}/user.
Eingabe-Schema
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The event id."
},
"shift_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The shift id."
},
"page": {
"description": "Page of results, from 1. Default 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Records per page, 1 to 100. Default 25.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"sort_by": {
"description": "Attribute to sort on, for example id. Sorting is not applied unless set.",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sort_order": {
"description": "Sort direction. Default asc.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"filter": {
"description": "Filter conditions. Each item is {attr, operator, value}. The filterable attributes differ per resource.",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"attr": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Attribute code to filter on."
},
"operator": {
"type": "string",
"minLength": 1,
"maxLength": 12,
"description": "Operator, for example = , > , < or like."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
],
"description": "Value to compare with."
}
},
"required": [
"attr",
"operator",
"value"
]
}
}
},
"required": [
"event_id",
"shift_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_get_shift_assignment(event_id, shift_id, shift_assignment_id)
Return one person's place on one shift: their status, check-in and check-out times, break and any rating. Rosterfy: GET /api/v2/event/{event_id}/shift/{shift_id}/user/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The event id."
},
"shift_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The shift id."
},
"shift_assignment_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The shift assignment id."
}
},
"required": [
"event_id",
"shift_id",
"shift_assignment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_list_training_modules(page, per_page, sort_by, sort_order, filter)
List the training modules the account can use, including modules from an account above it. Rosterfy: GET /api/v2/training.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page of results, from 1. Default 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Records per page, 1 to 100. Default 25.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"sort_by": {
"description": "Attribute to sort on, for example id. Sorting is not applied unless set.",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sort_order": {
"description": "Sort direction. Default asc.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"filter": {
"description": "Filter conditions. Each item is {attr, operator, value}. The filterable attributes differ per resource.",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"attr": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Attribute code to filter on."
},
"operator": {
"type": "string",
"minLength": 1,
"maxLength": 12,
"description": "Operator, for example = , > , < or like."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
],
"description": "Value to compare with."
}
},
"required": [
"attr",
"operator",
"value"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_list_training_assignments(training_id, page, per_page, sort_by, sort_order, ...)
List the people assigned to one training module, with each person's status and progress. Rosterfy: GET /api/v2/training/{training_id}/user.
Eingabe-Schema
{
"type": "object",
"properties": {
"training_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The training module id."
},
"page": {
"description": "Page of results, from 1. Default 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Records per page, 1 to 100. Default 25.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"sort_by": {
"description": "Attribute to sort on, for example id. Sorting is not applied unless set.",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sort_order": {
"description": "Sort direction. Default asc.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"filter": {
"description": "Filter conditions. Each item is {attr, operator, value}. The filterable attributes differ per resource.",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"attr": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Attribute code to filter on."
},
"operator": {
"type": "string",
"minLength": 1,
"maxLength": 12,
"description": "Operator, for example = , > , < or like."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
],
"description": "Value to compare with."
}
},
"required": [
"attr",
"operator",
"value"
]
}
}
},
"required": [
"training_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_list_certificate_holders(certificate_id, page, per_page, sort_by, sort_order, ...)
List the people a certificate was issued to, one row per issue. Give certificate_id for one certificate, or leave it out for all. Rosterfy: GET /api/v2/certificate/user or GET /api/v2/certificate/{certificate_id}/user.
Eingabe-Schema
{
"type": "object",
"properties": {
"certificate_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The certificate id."
},
"page": {
"description": "Page of results, from 1. Default 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Records per page, 1 to 100. Default 25.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"sort_by": {
"description": "Attribute to sort on, for example id. Sorting is not applied unless set.",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sort_order": {
"description": "Sort direction. Default asc.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"filter": {
"description": "Filter conditions. Each item is {attr, operator, value}. The filterable attributes differ per resource.",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"attr": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Attribute code to filter on."
},
"operator": {
"type": "string",
"minLength": 1,
"maxLength": 12,
"description": "Operator, for example = , > , < or like."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
],
"description": "Value to compare with."
}
},
"required": [
"attr",
"operator",
"value"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_get_reward_balance(user_id)
Return one user's reward point balance: the points they hold now and who they belong to. Rosterfy: GET /api/v2/reward-point/user/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The user id."
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_list_reports(page, per_page, sort_by, sort_order, filter)
List the account's reports and their generation state, one page at a time. This does not regenerate any report. Rosterfy: GET /api/v2/report.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page of results, from 1. Default 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Records per page, 1 to 100. Default 25.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"sort_by": {
"description": "Attribute to sort on, for example id. Sorting is not applied unless set.",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sort_order": {
"description": "Sort direction. Default asc.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"filter": {
"description": "Filter conditions. Each item is {attr, operator, value}. The filterable attributes differ per resource.",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"attr": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Attribute code to filter on."
},
"operator": {
"type": "string",
"minLength": 1,
"maxLength": 12,
"description": "Operator, for example = , > , < or like."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
}
],
"description": "Value to compare with."
}
},
"required": [
"attr",
"operator",
"value"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢rosterfy_get_report(report_id)
Return one report's definition and its generation state (queued, processing, completed or failed). This does not regenerate it. Rosterfy: GET /api/v2/report/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"report_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The report id."
}
},
"required": [
"report_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴rosterfy_assign_user_to_shift(event_id, shift_id, user_id, event_shift_status_id, is_leader)
Put one person on one shift at the status you give. Read the status id from rosterfy_get_event first. A status the account treats as cancelled, or a full shift, is refused with a 422. Rosterfy: POST /api/v2/event/{event_id}/shift/{shift_id}/user.
Eingabe-Schema
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The event id."
},
"shift_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The shift id."
},
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The user to put on the shift id."
},
"event_shift_status_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The shift status id."
},
"is_leader": {
"description": "Whether this person leads the shift.",
"type": "boolean"
}
},
"required": [
"event_id",
"shift_id",
"user_id",
"event_shift_status_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴rosterfy_remove_user_from_shift(event_id, shift_id, shift_assignment_id, repeat)
Take one person off one shift. The assignment is soft-deleted, so the history stays. On a linked series, the first call returns a 400 that asks about later shifts; repeat the call with repeat set to true to remove them from those too. Rosterfy: DELETE /api/v2/event/{event_id}/shift/{shift_id}/user/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The event id."
},
"shift_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The shift id."
},
"shift_assignment_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The shift assignment id."
},
"repeat": {
"description": "Also remove the person from every later linked shift.",
"type": "boolean"
}
},
"required": [
"event_id",
"shift_id",
"shift_assignment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet15 Tools