MCP Server

DeskMonitor

            com.thedeskmonitor/mcp
        

Business & Operations Data & Analytics Productivity Public & reachable MCP 2026-07-28

What this MCP does

Supports workforce attendance, timesheets, employee management, team hours, productivity reporting, workload alerts, approvals, and workforce analytics.

ask_workforce

Ask Workforce Question

Use when the user asks a free-form, open-ended question about their workforce that you are not sure which other tool answers — for example: 'Which team has the highest cost-to-output?', 'How is my team performing?', 'Who should I talk to first?', 'What's the biggest issue today?'. Pass the user's question VERBATIM in the 'question' field — do not paraphrase or summarize. The question is logged as admin-only product telemetry for product improvement purposes. This tool returns routing guidance pointing to the specific DeskMonitor tools most likely to answer the question. After calling this tool, call the suggested tools to retrieve real data. Note: Questions asked via this tool are logged for product improvement (admin-only, tenant-scoped, not employee data).

Read only

Input schema

{'type': 'object', 'required': ['question'], 'properties': {'question': {'type': 'string', 'maxLength': 2000, 'description': "The user's question about their workforce, in their own words. Pass verbatim — do not paraphrase."}}}

Output schema

{'type': 'object', 'properties': {'tip': {'type': 'string', 'description': 'Follow-up suggestion'}, 'message': {'type': 'string', 'description': 'Confirmation and routing guidance'}, 'acknowledged': {'type': 'boolean', 'description': 'Whether the question was captured'}, 'suggested_tools': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Tools most likely to answer this question'}, 'question_received': {'type': 'string', 'description': 'Echo of the question (truncated to 200 chars)'}}}

clock_in

Clock In

Clock the authenticated user in to start a new work session. Creates a TimeLog entry in DeskMonitor. Use when the user says 'clock me in', 'start my shift', 'I am starting work', or any attendance start phrase. Supports optional GPS coordinates for geofence validation. WARNING: This is a write tool — it mutates DeskMonitor data. Always confirm with the user before calling this tool. Example: tell the user what you are about to do and ask for explicit confirmation before proceeding. Calling clock_in will end any active DeskAgent desktop session for this user (cross-device handover by design). Do NOT call if the user is already clocked in — call get_dashboard_summary first to check status. Returns: { success, clock_in_time, is_within_geofence, matched_office_name, next_tap_due_at }. Requires a user-scoped API key (dm_live_* key bound to a specific user). Disabled in demo mode.

Destructive

Input schema

{'type': 'object', 'properties': {'latitude': {'type': 'number', 'description': 'GPS latitude (optional). Used for geofence validation.'}, 'longitude': {'type': 'number', 'description': 'GPS longitude (optional). Used for geofence validation.'}}}

Output schema

{'type': 'object', 'properties': {'error': {'type': 'string', 'description': 'Error code if clock-in failed'}, 'message': {'type': 'string', 'description': 'Human-readable result or error message'}, 'success': {'type': 'boolean', 'description': 'Whether the clock-in succeeded'}, 'clock_in_time': {'type': 'string', 'description': 'ISO 8601 clock-in timestamp'}, 'next_tap_due_at': {'type': 'string', 'description': 'When the next attendance tap is expected'}, 'is_within_geofence': {'type': 'boolean', 'description': 'Whether the location is within a configured geofence'}, 'matched_office_name': {'type': 'string', 'description': 'Name of the matched office/geofence, if any'}}}

clock_out

Clock Out

Clock the authenticated user out to end their current work session. Finalises the TimeLog and generates gap-fill blocks. Use when the user says 'clock me out', 'end my shift', 'I am done for the day', or any attendance end phrase. WARNING: This is a write tool — it mutates DeskMonitor data. Always confirm with the user before calling this tool. Do NOT call if the user is already clocked out — call get_dashboard_summary first to check status. Returns: { success, clock_in_time, clock_out_time, blocks_generated }. Requires a user-scoped API key. Disabled in demo mode.

Destructive

Input schema

{'type': 'object', 'properties': {'latitude': {'type': 'number', 'description': 'GPS latitude at clock-out (optional).'}, 'longitude': {'type': 'number', 'description': 'GPS longitude at clock-out (optional).'}}}

Output schema

{'type': 'object', 'properties': {'error': {'type': 'string', 'description': 'Error code if clock-out failed'}, 'message': {'type': 'string', 'description': 'Human-readable result or error message'}, 'success': {'type': 'boolean', 'description': 'Whether the clock-out succeeded'}, 'clock_in_time': {'type': 'string', 'description': 'ISO 8601 clock-in timestamp for this session'}, 'clock_out_time': {'type': 'string', 'description': 'ISO 8601 clock-out timestamp'}, 'blocks_generated': {'type': 'integer', 'description': 'Number of gap-fill TimeLog blocks created'}}}

get_analytics_feature_usage

Platform Feature Usage Breakdown

Returns a breakdown of which DeskMonitor MCP tools users are calling most — sourced from the internal McpAuditLogs table, grouped by ToolName (top-N tool call counts for the period). Use when the user asks: 'which MCP tools are most used?', 'which features are most popular?', 'what do AI clients do most in DeskMonitor?', 'show me feature engagement'. Do NOT use for: raw session counts or audience size (use get_analytics_overview), employee-level productivity data (use get_productivity_overview), or real-time attendance data. Auth: requires Admin or OwnerAdmin API key. Not available in demo mode. Returns: feature_areas (list with tool_name and call_count), top_events, period, as_of.

Read only

Input schema

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 25, 'description': 'Number of feature areas to return.'}, 'period': {'enum': ['this_week', 'last_week', 'this_month', 'last_month'], 'type': 'string', 'default': 'this_week', 'description': 'Reporting window for tool call counts. Default: this_week.'}}}

Output schema

{'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'Snapshot timestamp'}, 'period': {'type': 'string', 'description': 'Reporting window used'}, 'available': {'type': 'boolean', 'description': 'Whether analytics data is available'}, 'top_events': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top event names with counts'}, 'feature_areas': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top tool call counts grouped by ToolName'}}}

get_analytics_overview

Platform Analytics Overview

Returns platform-level DeskMonitor analytics — AI/MCP queries served (from the internal McpAuditLogs table), web sessions, active unique visitors (1-day, 7-day, 28-day windows) and top referring sources (from Cloudflare Web Analytics when configured). Use when the user asks: 'how many users does DeskMonitor have?', 'show me traffic stats', 'how many AI queries were served?', 'how many people are using DeskMonitor?', or any question about platform-level usage counts or audience size. Do NOT use for: per-tenant employee data (use get_dashboard_summary), individual timesheet data (use list_my_timesheet), or real-time attendance (use get_workload_alerts). Auth: requires an Admin or OwnerAdmin API key. Not available in demo mode. Returns: active_users_1d, active_users_7d, active_users_28d, sessions_in_period, ai_queries_served_in_period, top_sources (up to 5), period, as_of. Web traffic fields are 0 when Cloudflare Analytics is not configured (AI query count is always present).

Read only

Input schema

{'type': 'object', 'properties': {'period': {'enum': ['today', 'this_week', 'last_week', 'this_month', 'last_month'], 'type': 'string', 'default': 'this_week', 'description': 'Reporting window for session and AI-query counts.'}}}

Output schema

{'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'Snapshot timestamp'}, 'period': {'type': 'string', 'description': 'Reporting window used'}, 'available': {'type': 'boolean', 'description': 'Whether analytics data is available'}, 'top_sources': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top referring sources with session counts'}, 'active_users_1d': {'type': 'integer', 'description': 'Unique active users in the last 1 day'}, 'active_users_7d': {'type': 'integer', 'description': 'Unique active users in the last 7 days'}, 'active_users_28d': {'type': 'integer', 'description': 'Unique active users in the last 28 days'}, 'sessions_in_period': {'type': 'integer', 'description': 'Total sessions in the reporting window'}, 'ai_queries_served_in_period': {'type': 'integer', 'description': 'MCP tool calls served from McpAuditLogs'}}}

get_analytics_questions

Demand Analytics — Questions & Themes

Returns demand intelligence captured from ask_workforce calls: recent verbatim admin questions, top question themes with counts, and the most-requested 'period' argument values across all tools. Use when the admin asks: 'What questions have I asked?', 'What am I asking most?', 'What data am I looking for?', 'Show me my question history', 'What features am I using most?'. Auth: requires Admin or OwnerAdmin role. Not available in demo mode. Tenant-scoped — only returns this tenant's data.

Read only

Input schema

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'description': 'Max number of recent questions to return.'}, 'period': {'enum': ['today', 'this_week', 'last_week', 'this_month', 'last_month'], 'type': 'string', 'default': 'this_month', 'description': 'Reporting window for question history.'}}}

Output schema

{'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'Snapshot timestamp'}, 'period': {'type': 'string', 'description': 'Reporting window used'}, 'available': {'type': 'boolean', 'description': 'Whether results are available (false in demo mode)'}, 'top_themes': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Theme groupings with counts'}, 'privacy_note': {'type': 'string', 'description': 'Privacy scope note'}, 'period_demand': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Most-requested period argument values'}, 'question_count': {'type': 'integer', 'description': 'Number of questions returned'}, 'recent_questions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Recent verbatim questions with timestamps'}}}

get_capabilities

Capabilities

Returns a structured list of DeskMonitor AI capabilities grouped by user role AND plan entitlements. Includes MCP / AI assistant plan entitlements (Community=No MCP; Starter/Professional/Business/Enterprise=Yes MCP). Use when a new user asks 'what can I ask you?', 'what can DeskMonitor do?', 'show me all commands', 'what AI features are available?', 'which plan includes MCP?', 'do I need a paid plan for AI access?', or any capability-discovery or plan-entitlement question. Returns role-appropriate command examples, plan entitlements, and the public capabilities page URL. No authentication required.

Read only

Input schema

{'type': 'object', 'properties': {}}

Output schema

{'type': 'object', 'properties': {'support': {'type': 'object', 'description': 'Support contact information'}, 'platforms': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Platform availability (web, desktop, mobile)'}, 'compliance': {'type': 'object', 'description': 'Compliance status (GDPR etc)'}, 'industries': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Target industry verticals'}, 'tool_names': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of all tool name strings'}, 'sso_roadmap': {'type': 'string', 'description': 'SSO roadmap status'}, 'total_tools': {'type': 'integer', 'description': 'Total number of MCP tools available'}, 'write_tools': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Tools that mutate data'}, 'data_storage': {'type': 'object', 'description': 'Cloud provider and data residency'}, 'report_types': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Available report types'}, 'changelog_url': {'type': 'string', 'description': 'URL to product changelog'}, 'org_structure': {'type': 'object', 'description': 'Org hierarchy and role levels'}, 'privacy_model': {'type': 'object', 'description': 'Privacy and monitoring model details'}, 'sso_available': {'type': 'boolean', 'description': 'Whether SSO is currently live'}, 'related_resources': {'type': 'object', 'description': 'Deep-link to the capabilities reference page'}, 'api_key_permissions': {'type': 'object', 'description': 'API key scope and permission model'}, 'remote_team_support': {'type': 'object', 'description': 'Remote team support details'}, 'capabilities_by_role': {'type': 'object', 'description': 'Commands grouped by role: everyone, manager_above, admin_owner_admin'}, 'payment_integrations': {'type': 'object', 'description': 'PayPal/Wise integration status by use case'}, 'supported_ai_clients': {'type': 'object', 'description': 'Confirmed and in-development AI client integrations'}, 'employee_self_service': {'type': 'object', 'description': 'Self-service features available to employees'}}}

get_dashboard_summary

Dashboard Summary

Returns the dashboard KPIs for the current user — hours worked today, team productivity score, pending approvals, active headcount. Use when the user asks 'how is my team today?', 'am I clocked in?', 'what's my summary?'. Do NOT use for historical timesheet data — use list_my_timesheet for that.

Read only

Input schema

{'type': 'object', 'properties': {}}

Output schema

{'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'ISO 8601 timestamp of the snapshot'}, 'error': {'type': 'string', 'description': 'Error message if retrieval failed'}}}

get_data_dictionary

Data Dictionary

Returns the schema of queryable data — what fields exist, their meaning, and which tools expose them. Includes the RetentionPolicy entity — how long screenshots and monitoring data are kept per plan. Use when the user asks 'what data exists?', 'what fields are available?', 'what is a productivity score?', or 'what is the data retention policy?'. NOT for querying live data — use the analytics tools for live results.

Read only

Input schema

{'type': 'object', 'properties': {}}

Output schema

{'type': 'object', 'properties': {'entities': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of data entity definitions, each with name, description, fields array, and exposed_by_tool'}}}

get_demo_scenarios

Demo Scenarios

Returns 5 guided scenario walkthroughs using the demo tenant's synthetic data. Use when the user wants to see example queries or guided tours of DeskMonitor capabilities.

Read only

Input schema

{'type': 'object', 'properties': {}}

Output schema

{'type': 'object', 'properties': {'scenarios': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of scenario objects, each with id, title, description, and suggested_queries array'}}}

get_employee_details

Employee Details

Returns the full profile for a specific employee including role, team, clock-in status, and recent activity. Use when the user asks about ONE specific person. Use list_employees for multiple people. Use 'me' as employee_id for the authenticated user's own profile.

Read only

Input schema

{'type': 'object', 'required': ['employee_id'], 'properties': {'employee_id': {'type': 'string', 'description': "Employee ID (UUID) or 'me' for the authenticated user."}}}

Output schema

{'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Employee UUID'}, 'name': {'type': 'string', 'description': 'Full name'}, 'role': {'type': 'string', 'description': 'Employee role'}, 'team': {'type': 'string', 'description': 'Team name'}, 'email': {'type': 'string', 'description': 'Work email'}, 'is_clocked_in': {'type': 'boolean', 'description': 'Whether currently clocked in'}}}

get_pricing_and_plans

Pricing and Plans

Returns DeskMonitor pricing plans and subscription details including MCP / AI access entitlement per plan, and per-plan retention periods for screenshots and monitoring data. Plans: Community (free, no MCP), Starter ($14/mo, MCP included), Professional ($27/mo, MCP included), Business ($51/mo, MCP included), Enterprise (Contact Sales — no public price). Use when the user asks 'how much does DeskMonitor cost?', 'what plans are available?', 'is there a free trial?', 'what\'s the pricing?', 'which plan has MCP?', 'what is the Enterprise price?', 'how long are screenshots kept?', 'what is the data retention policy?'. Returns plan names, features, pricing, retention periods, and pricing page URL. Safe to call without authentication.

Read only

Input schema

{'type': 'object', 'properties': {}}

Output schema

{'type': 'object', 'properties': {'note': {'type': 'string', 'description': 'Data freshness note'}, 'plans': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of plan objects (Community, Starter, Professional, Business, Enterprise)'}, 'demo_mode': {'type': 'object', 'description': 'Demo mode availability'}, 'free_trial': {'type': 'object', 'description': 'Free trial availability and duration'}, 'data_source': {'type': 'string', 'description': 'live_db or fallback'}, 'upgrade_url': {'type': 'string', 'description': 'URL to upgrade or manage billing'}, 'change_plan_note': {'type': 'string', 'description': 'Guidance on changing plans'}, 'related_resources': {'type': 'object', 'description': 'Pricing and signup page URLs'}, 'billing_portal_url': {'type': 'string', 'description': 'URL to the billing portal'}, 'payment_integrations': {'type': 'object', 'description': 'PayPal/Wise integration status'}}}

get_productivity_overview

Productivity Overview

Returns productivity scores and active/idle time ratios for an employee or team. Use when the user asks 'what\'s my productivity score?', 'how productive was the team?', or 'show me active vs idle time'. Employee sees own data only. Manager+ can query other team member IDs. Privacy: scoring is category-based (app-usage duration only) -- DeskMonitor does NOT track keystrokes, content, or individual URLs browsed. The response always includes a privacy_note field with this clarification.

Read only

Input schema

{'type': 'object', 'properties': {'period': {'enum': ['today', 'this_week', 'last_week', 'this_month'], 'type': 'string', 'default': 'this_week'}, 'user_id': {'type': 'string', 'format': 'uuid', 'description': 'Target user. Defaults to authenticated user. Manager+ can specify team member IDs.'}}}

Output schema

{'type': 'object', 'properties': {'score': {'type': 'integer', 'description': 'Productivity score 0-100'}, 'week_end': {'type': 'string', 'description': 'Period end date (YYYY-MM-DD)'}, 'week_start': {'type': 'string', 'description': 'Period start date (YYYY-MM-DD)'}, 'privacy_note': {'type': 'string', 'description': 'Privacy clarification for activity scoring'}, 'totalSeconds': {'type': 'integer', 'description': 'Total tracked seconds'}, 'period_applied': {'type': 'string', 'description': 'Period enum value used'}, 'data_availability': {'type': 'string', 'description': 'available | no_data | synthetic_demo'}, 'productiveSeconds': {'type': 'integer', 'description': 'Seconds of productive app use'}}}

get_started_guide

Get Started Guide

Returns a role-scoped welcome message and curated sample questions to help you get started with DeskMonitor AI. Use when a new user asks 'what can I do?', 'what can I ask?', or 'how do I get started?' Call this first when connecting. Do NOT use for querying live workforce data.

Read only

Input schema

{'type': 'object', 'properties': {'role': {'enum': ['employee', 'manager', 'admin', 'owner_admin', 'demo'], 'type': 'string', 'description': 'Your role hint. If omitted, inferred from auth token.'}}}

Output schema

{'type': 'object', 'properties': {'mode': {'type': 'string', 'description': 'demo or production'}, 'support': {'type': 'object', 'description': 'Support contact information'}, 'tenant_name': {'type': 'string', 'description': 'Tenant display name'}, 'api_key_note': {'type': 'string', 'description': 'API key setup guidance'}, 'mcp_server_url': {'type': 'string', 'description': 'MCP server endpoint URL'}, 'mcp_auth_method': {'type': 'string', 'description': 'Auth method description'}, 'welcome_message': {'type': 'string', 'description': 'Role-scoped welcome text'}, 'sample_questions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Curated starter questions for this role'}, 'api_key_setup_url': {'type': 'string', 'description': 'URL to generate an API key'}, 'mcp_config_snippet': {'type': 'string', 'description': 'Ready-to-paste MCP client config JSON'}}}

get_workload_alerts

Workload Alerts

Returns workload alerts — team members with unusual hours, employees not yet clocked in, timesheet gaps. Use when the manager asks 'who needs attention?', 'any anomalies today?', 'any warnings?', or 'are there any issues?'.

Read only

Input schema

{'type': 'object', 'properties': {'date': {'type': 'string', 'format': 'date', 'description': 'Date to check. Defaults to today.'}}}

Output schema

{'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'Snapshot timestamp'}, 'alerts': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of workload alert items per employee'}, 'total_count': {'type': 'integer', 'description': 'Total number of alerts'}}}

invite_staff

Invite Staff Member

Invite a staff member to join your DeskMonitor workspace by email. Use when the user asks to 'add an employee', 'invite a team member', 'send a team invite', 'onboard someone new', or 'invite [name] to my workspace'. The invite is sent by email — the recipient gets a link to set up their account and join as an Employee. Only OwnerAdmin and Admin roles can invite staff. The invitee always joins as an Employee (role is display-only on the invite). WARNING: This is a write tool — it sends a real email invitation and creates a workspace account invitation. Always confirm the email address with the user before calling this tool. Disabled in demo mode. Returns: { status, message, email, name }.

Destructive

Input schema

{'type': 'object', 'required': ['email'], 'properties': {'name': {'type': 'string', 'description': 'Full name of the person to invite (shown in the invitation email). Optional but recommended.'}, 'email': {'type': 'string', 'description': 'Email address of the person to invite. Must be a valid email. Required.'}}}

Output schema

{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Name on the invitation, if provided'}, 'email': {'type': 'string', 'description': 'Email address the invite was sent to'}, 'error': {'type': 'string', 'description': 'Error code if invitation failed'}, 'status': {'type': 'string', 'description': 'invitation_sent or error code'}, 'message': {'type': 'string', 'description': 'Human-readable result message'}}}

list_employees

List Employees

Lists employees visible to the current user based on their role. Supports pagination and name search. Use when the user asks 'who is on my team?', 'list all employees', or wants a roster. Use get_employee_details for information about ONE specific person.

Read only

Input schema

{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Page number (1-based). Default: 1.'}, 'search': {'type': 'string', 'description': 'Name or email search filter'}, 'team_id': {'type': 'string', 'format': 'uuid', 'description': 'Filter by team (manager scope)'}, 'page_size': {'type': 'integer', 'default': 20, 'maximum': 100, 'description': 'Number of employees per page (max 100). Default: 20.'}}}

Output schema

{'type': 'object', 'properties': {'result': {'type': 'object', 'description': 'Paginated result: employees array, total count, current page'}, 'applied_filters': {'type': 'object', 'description': 'Echo of filters used: team_id, search, page, page_size'}}}

list_my_timesheet

My Timesheet

Returns the authenticated user's time log entries for a date range. Use when the user asks 'how many hours have I worked?', 'show me my timesheet', or 'what did I work on yesterday?'. Cannot query another person's timesheet — use summarize_team_hours for team-level hours.

Read only

Input schema

{'type': 'object', 'properties': {'to': {'type': 'string', 'format': 'date', 'description': 'End date (YYYY-MM-DD). Defaults to today.'}, 'from': {'type': 'string', 'format': 'date', 'description': 'Start date (YYYY-MM-DD). Defaults to 30 days ago.'}}}

Output schema

{'type': 'object', 'properties': {'entries': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of timesheet entries'}, 'total_hours': {'type': 'number', 'description': 'Total hours in the date range'}}}

list_pending_approvals

Pending Approvals

Returns timesheets pending approval in the manager's team. Requires Manager role or above. Use when the manager asks 'show me pending approvals', 'who needs sign-off?', or 'any outstanding timesheets?'. Read-only -- this tool LISTS pending items only; it cannot approve them. To approve, direct the user to the DeskMonitor dashboard: https://thedeskmonitor.com/timesheets/pending

Read only

Input schema

{'type': 'object', 'properties': {'team_id': {'type': 'string', 'format': 'uuid', 'description': 'Optional team UUID to filter pending approvals. Omit for all teams visible to this user.'}}}

Output schema

{'type': 'object', 'properties': {'count': {'type': 'integer', 'description': 'Number of pending approval items'}, 'items': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of pending approval records'}}}

list_recent_activity

Recent Activity

Returns a daily aggregate activity feed scoped to the authenticated user, including clock events, timesheet submissions, and approval actions. Use when the user asks 'show me recent activity', 'what happened today?', or 'what did I do yesterday?'. Not a real-time stream — data reflects completed events within the selected time window.

Read only

Input schema

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50}, 'since': {'type': 'string', 'format': 'date-time', 'description': 'Return activity after this timestamp. Defaults to 24h ago.'}}}

Output schema

{'type': 'object', 'properties': {'events': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of activity events'}}}

start_free_trial

Start Free Trial

Returns the DeskMonitor free trial sign-up URL and onboarding instructions. Use when the user says 'I want to sign up', 'start a free trial', 'how do I get started?', 'create an account', 'I want to use DeskMonitor'. This is an informational tool — it provides the registration URL, not a write action. No authentication required.

Read only

Input schema

{'type': 'object', 'properties': {}}

Output schema

{'type': 'object', 'properties': {'demo_first': {'type': 'object', 'description': 'Demo key and description for pre-signup exploration'}, 'signup_url': {'type': 'string', 'description': 'Registration URL with UTM tracking'}, 'api_key_note': {'type': 'string', 'description': 'API key setup guidance'}, 'trial_details': {'type': 'object', 'description': "Trial duration, no-credit-card status, what's included"}, 'mcp_server_url': {'type': 'string', 'description': 'MCP server endpoint URL'}, 'enterprise_path': {'type': 'object', 'description': 'Enterprise qualification pathway guidance'}, 'onboarding_steps': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Step-by-step getting started guide'}, 'api_key_setup_url': {'type': 'string', 'description': 'URL to generate an API key'}, 'related_resources': {'type': 'object', 'description': 'Signup URL and label'}, 'mcp_config_snippet': {'type': 'string', 'description': 'Ready-to-paste MCP client config JSON'}}}

summarize_team_hours

Team Hours Summary

Aggregates hours worked by the manager's team for a given period. Requires Manager role or above. Use when the manager asks 'how many hours did my team work this week?', 'show me team hours', or 'who worked the most hours?'. Do NOT use for an individual employee's timesheet — use list_my_timesheet for personal timesheets.

Read only

Input schema

{'type': 'object', 'properties': {'period': {'enum': ['today', 'this_week', 'last_week', 'this_month', 'last_month'], 'type': 'string', 'default': 'this_week'}, 'team_id': {'type': 'string', 'format': 'uuid', 'description': "Team ID (UUID) to scope the report. Defaults to the manager's primary team if omitted."}}}

Output schema

{'type': 'object', 'properties': {'result': {'type': 'object', 'description': 'Team hours breakdown from the attendance report'}, 'period_end': {'type': 'string', 'description': 'Computed end date (YYYY-MM-DD)'}, 'period_start': {'type': 'string', 'description': 'Computed start date (YYYY-MM-DD)'}, 'scope_team_id': {'type': 'string', 'description': 'Resolved team UUID or null for org-wide'}, 'period_applied': {'type': 'string', 'description': 'Period enum value used'}, 'scope_team_name': {'type': 'string', 'description': 'Resolved team name'}}}

switch_to_demo

Switch to Demo Mode

Switches to DeskMonitor demo mode with synthetic data. Returns demo tenant info and suggested queries. Use when the user wants to explore without a real account. Use a dm_demo_* API key to call data tools in demo mode.

Read only

Input schema

{'type': 'object', 'properties': {}}

Output schema

{'type': 'object', 'properties': {'mode': {'type': 'string', 'description': "Always 'demo'"}, 'note': {'type': 'string', 'description': 'Instructions for calling data tools in demo mode'}, 'message': {'type': 'string', 'description': 'Activation confirmation message'}, 'demo_tenant_id': {'type': 'string', 'description': 'Demo tenant readable ID (DEMO-000001)'}, 'sample_questions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Suggested queries to try in demo mode'}}}

switch_to_production

Switch to Production Mode

Switches back to production mode and confirms your real tenant context from your auth token. Use when the user wants to see their real company data after exploring demo mode.

Read only

Input schema

{'type': 'object', 'properties': {}}

Output schema

{'type': 'object', 'properties': {'mode': {'type': 'string', 'description': "Always 'production'"}, 'message': {'type': 'string', 'description': 'Confirmation or onboarding guidance'}, 'user_id': {'type': 'string', 'description': 'Authenticated user ID'}, 'tenant_readable_id': {'type': 'string', 'description': "The authenticated tenant's readable ID"}}}

Changed

                            get_pricing_and_plans
                        

Sept. 23, 2026, 2:54 a.m.

Changed

                            get_data_dictionary
                        

Sept. 23, 2026, 2:54 a.m.

Added

                            get_analytics_feature_usage
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_analytics_overview
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_analytics_questions
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            ask_workforce
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            start_free_trial
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_pricing_and_plans
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_capabilities
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            invite_staff
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            clock_out
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            clock_in
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_productivity_overview
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_workload_alerts
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            list_recent_activity
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            list_pending_approvals
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            summarize_team_hours
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            list_my_timesheet
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_employee_details
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            list_employees
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_dashboard_summary
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_demo_scenarios
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            switch_to_production
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            switch_to_demo
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_data_dictionary
                        

Sept. 17, 2026, 12:37 p.m.

Added

                            get_started_guide
                        

Sept. 17, 2026, 12:37 p.m.

Server details

Version

1.7.3

Transport

Streamable HTTP

Tools

Latency

900 ms

Last scan

Oct. 1, 2026, 2:54 a.m.

First seen

Sept. 13, 2026, 2:13 a.m.

Endpoint

https://api.thedeskmonitor.com/api/mcp/v1

Recent scans

Success

Oct. 1, 2026, 2:54 a.m.

Success

Sept. 29, 2026, 3:03 a.m.

Success

Sept. 27, 2026, 2:54 a.m.

Success

Sept. 25, 2026, 3:03 a.m.

Success

Sept. 23, 2026, 2:54 a.m.

Success

Sept. 21, 2026, 3:01 a.m.

Success

Sept. 19, 2026, 2:52 a.m.

Success

Sept. 17, 2026, 1:01 p.m.

Success

Sept. 17, 2026, 12:37 p.m.

DeskMonitor

What this MCP does

Tools

Recent tool changes

Similar MCP servers

AIOProductOS MCP

roadflow

Atisbo

Elasticflow

freedom-mcp

synter-ads

synter-ads

Stratalize Finance