MCP SERVER · OFFICIAL PROJECTAsk freispace who is free next week, who has worked with whom, and what was quoted and billed on an order.
LABSCO SUMMARY
get_staff_next_holiday returns the day the person is actually back at work, not the day after the holiday ends — working times, shifts, public holidays and other absences all sit in between. That is exactly the kind of question a model guessing from a calendar gets confidently wrong.
An analytics layer over freispace, the scheduling system for media and post-production teams. Lookups are name-based — partial names match — and every answer is scoped to what the calling user is allowed to see.
The npm package @freispace/mcp-server-analytics over stdio. It needs a freispace Flagship account and an MCP API key — during the beta that key comes from freispace support. Permissions are enforced per user, so the model only reaches data that user could already open.
One command — npx -y @freispace/mcp-server-analytics
USE CASES
Check availability for both across a date window, with a required duration, in one pass.
Upcoming holiday blocks plus the real next working day, and how much quota is left.
Pull an order with its offers and invoices attached instead of reconciling three lists.
Task status across the project and its bookings, with an open, done and overdue summary.
Shared bookings between colleagues, and the projects each person is booked on.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
find_resourcesSearch rooms/studios (suites), equipment/licenses (resources) and staff by name in one call; results are grouped by type. Call without search to list everything. Use it to find entities and the exact names to pass to other tools.
get_availabilityCheck when staff, rooms (suites) or resources are FREE in a date window (default 14 days, max 92). Considers bookings, public holidays and staff absences/work times. Returns free time slots and fully-free days per entity, and whether a required duration fits. Select entities with search/site/status (names from find_resources).
get_current_userWho the calling user is: name, email and their linked staff record. Use it to resolve 'I', 'me' or 'my' to a staff name for other tools.
get_invoicesList invoices with filters and per-currency totals; paginated. Status buckets: draft, open (finalized & unpaid, includes overdue), overdue, paid, partially-paid, canceled, locked. To find a client's invoices use search — it matches number, order number, subject and recipient address.
get_my_scheduleThe calling user's own bookings in a date window (default: the next 7 days). Use it for questions like 'what is on my schedule this week'.
get_my_tasksTasks assigned to the calling user, with due date, priority and what they reference. Default: open tasks only.
get_offersList offers (quotes) with filters and per-currency net totals; paginated. Status buckets: draft, locked, open (finalized, no decision yet), accepted, declined. Each offer shows how many invoices were created from it. Search matches number, order number, subject and recipient address.
get_open_tasksAll open (not yet completed) tasks of the team, with assignees, due dates and what they reference. For only the calling user's own tasks use get_my_tasks.
get_ordersList orders (jobs) with their connected offers and invoices inline; paginated. Use it for questions like 'what was quoted and billed on order X'. Search matches order number and name.
get_project_statsBooking statistics for one project: how many bookings are in the past vs upcoming, with a per-status breakdown. Also returns the project timespan: when the first booking starts, when the last booking ends (local date + time) and the duration in days between them.
get_project_tasksTask status of one project: all tasks on the project and its bookings, with a summary of how many are open, done and overdue.
get_project_teamList the staff members who worked on a project, with each person's number of bookings on it.
get_staff_collaboratorsShow who a staff member has worked with, based on shared bookings: each colleague with the bookings and projects they shared.
get_staff_holiday_quotaGet a staff member's holiday quota for one year: total, taken and remaining days. Omit staff_name to get the calling user's own quota.
get_staff_next_holidayGet ALL upcoming holiday blocks of a staff member plus their next work day — the day they are actually back at work, accounting for working times, shifts, public holidays and other absences. To answer 'when is X back?' always use the returned next work day; never derive it from a holiday's end date (the staff may have days off, public holidays or further absences right after it). Omit staff_name to get the calling user's own holidays.
get_staff_projectsList the projects a staff member is booked on, with each project's date range and duration in days.
get_staffsList staff members with name, title and staff number. Default: active staff only. Use it to browse the team or to find the exact staff name for other tools.
search_docsSearch the freispace documentation. Returns the most relevant excerpts. Use it for questions about how freispace itself works (features, settings, how-tos).
BEFORE YOU INSTALL
18 tools when we connected.
npx on PATH
CONTEXT COST
Rated by the size of the 18 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Add the block to your client, or run the command directly.
{
"mcpServers": {
"mcp-server-analytics": {
"command": "npx",
"args": [
"-y",
"@freispace/mcp-server-analytics"
]
}
}
}npx -y @freispace/mcp-server-analyticsMCP servers
appunite
pcmarts
dannydaley76