MCP server
Rosterfy MCP by usefulapi
Read people, events, training and rewards; assign and remove people on shifts in Rosterfy.
- Runs
- Remotely
- Version
- 1.4.0
- Listing updated
- 4 days ago
About Rosterfy MCP by usefulapi
Rosterfy MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http rosterfy https://rosterfy.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://rosterfy.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"rosterfy": {
"url": "https://rosterfy.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"rosterfy": {
"type": "http",
"url": "https://rosterfy.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"rosterfy": {
"serverUrl": "https://rosterfy.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"rosterfy": {
"type": "http",
"url": "https://rosterfy.usefulapi.io/mcp"
}
}
}Tools this server provides (15)
Read directly from the server.
- 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.
- rosterfy_list_users
- 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.
- rosterfy_get_user
- Return one person's full record, with their subscription and verification state. Rosterfy: GET /api/v2/user/{id}.
- rosterfy_list_events
- 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.
- rosterfy_get_event
- 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}.
- rosterfy_list_shift_assignments
- 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.
- rosterfy_get_shift_assignment
- 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}.
- rosterfy_list_training_modules
- List the training modules the account can use, including modules from an account above it. Rosterfy: GET /api/v2/training.
- rosterfy_list_training_assignments
- List the people assigned to one training module, with each person's status and progress. Rosterfy: GET /api/v2/training/{training_id}/user.
- rosterfy_list_certificate_holders
- 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.
- rosterfy_get_reward_balance
- 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}.
- rosterfy_list_reports
- 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.
- rosterfy_get_report
- 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}.
- rosterfy_assign_user_to_shift
- 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.
- rosterfy_remove_user_from_shift
- 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}.
Rosterfy MCP by usefulapi FAQ
How do I add Rosterfy MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http rosterfy https://rosterfy.usefulapi.io/mcp