freispace MCP Server

A Model Context Protocol (MCP) server that provides comprehensive analytics and insights for the scheduling software freispace. This server enables AI assistants (e.g. Copilot, Gemini) to query data within freispace, such as project statistics and planning related information.

Overview

The freispace MCP Server connects any LLM with tooling capabilities to freispace to query analytical data.

Media teams using freispace can leverage the MCP server to make planning data available to the entire company using the company-wide AI (e.g. Copilot), without users having to be on freispace or even know about freispace, as well as help post-production teams make data-driven decisions while scheduling and planning.

Our MCP Server always respects user permissions, ensuring that the LLM will only be able to access data on a per-user level, ensuring data safety.

Example queries might be "Who worked with Person X in the past" or "How many vacation days do I have left?"

Features

• Staff Management: Complete staff directory, collaboration analysis, and holiday tracking
• Project Analytics: Project status, team composition, and performance metrics
• Resource Management: Suite, resource, and staff availability tracking
• Holiday Planning: Holiday quota management and upcoming absence tracking
• Collaboration Insights: Team dynamics and working relationship analysis

Prerequisites

1. freispace Flagship account
2. Valid MCP API key for freispace
   • During beta, contact your freispace support team to obtain an MCP API key

Available Tools

1. Staff Directory (staffs_query)

Retrieves comprehensive information about all staff members in the organization.

Use Cases:

• Get overview of all employees
• Understand organizational structure
• Find staff members by role or department
• Generate staff reports

Example Queries:

• "List all staff members"
• "Who are the developers in the company?"
• "Show me the organizational structure"

2. Staff Collaboration Analysis (staffs_worked_together_query)

Analyzes collaboration patterns and working relationships for specific staff members.

Parameters:

• name (required): Staff member name

Use Cases:

• Analyze team dynamics
• Find collaboration patterns
• Understand project participation
• Generate collaboration reports

Example Queries:

• "Who has John worked with on projects?"
• "Show collaboration history for Sarah"
• "Analyze team relationships"

3. Holiday Management

Next Holidays (staffs_next_holidays_query)

Shows upcoming holiday information for staff members.

Parameters:

• name (optional): Staff member name (defaults to user's assigned staff)

Use Cases:

• Plan around staff availability
• Check upcoming absences
• Holiday scheduling

Example Queries:

• "When is John's next holiday?"
• "Show upcoming holidays"
• "Who's going on holiday soon?"

Holiday Quota (staffs_holidays_left_query)

Tracks remaining holiday days for staff members.

Parameters:

• name (optional): Staff member name
• year (optional): Year to query (defaults to current year)

Use Cases:

• Monitor holiday usage
• Plan holiday requests
• Resource planning

Example Queries:

• "How many holiday days does Sarah have left?"
• "Show holiday quota for 2024"
• "Who has the most holiday days remaining?"

4. Project Analytics

Project Status (get_project_status)

Provides comprehensive project performance and booking statistics.

Parameters:

• name (required): Project name

Use Cases:

• Analyze project performance
• Track booking patterns
• Generate project reports
• Monitor project activity

Example Queries:

• "Show status for Project Alpha"
• "Analyze booking patterns for the mobile app project"
• "Generate project performance report"

Project Team (get_staffs_worked_on_project)

Lists all staff members who have worked on a specific project.

Parameters:

• name (required): Project name

Use Cases:

• Identify project team members
• Analyze team composition
• Track project participation
• Generate team reports

Example Queries:

• "Who worked on the website redesign?"
• "Show team members for Project Beta"
• "Analyze project team composition"

Staff Projects (get_staff_projects)

Shows all projects assigned to a specific staff member.

Parameters:

• name (required): Staff member name

Use Cases:

• Understand staff workload
• Analyze project assignments
• Track staff project portfolio
• Resource allocation planning

Example Queries:

• "What projects is John working on?"
• "Show Sarah's project assignments"
• "Analyze staff workload distribution"

5. Resource Search (get_entities_by_name)

Searches for suites, resources, and staff members by name with availability filtering.

Parameters:

• name (required): Search term
• available_only (optional): Show only available entities
• booked_only (optional): Show only booked entities

Use Cases:

• Find available resources
• Search for specific entities
• Check availability status
• Resource planning

Example Queries:

• "Find available meeting rooms"
• "Search for camera equipment"
• "Show booked resources for today"

Error Handling

The server includes comprehensive error handling for:

• API connectivity issues
• Invalid parameters
• Missing data
• Authentication failures
• Network timeouts

All errors are logged with detailed information for debugging.

⚠️ Beta Notice

Our freispace MCP server is currently in beta. All features are free during this period. We appreciate your feedback and patience as we continue to improve the platform.

License

MIT License - see LICENSE file for details.

Support

For support and questions:

• Documentation: freispace documentation
• Issues: GitHub Issues
• Contact: freispace Support