Modus MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MODUS_API_URL | No | Override API endpoint (default: https://api.himodus.com) | https://api.himodus.com |
| TRANSPORT_MODE | No | Set to stdio for local use (default) | stdio |
| MODUS_API_TOKEN | Yes | Your Modus API token (starts with modus_sk_) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| modus_get_current_headcountB | Get current headcount by team, role, or department with filtering. Returns employee data including roles, departments, and employment status. |
| modus_get_attrition_risksA | Get ML-powered attrition risk predictions with confidence scores (0-1). Returns employees at risk of leaving with risk factors and confidence levels. Uses cached insights by default for speed, set fresh=true for real-time analysis. |
| modus_get_open_positionsA | Get open job requisitions and hiring forecast by quarter. Returns open positions with status, department, and planned start dates. |
| modus_get_ramp_profilesA | Get ramp time profiles showing how long new hires take to reach full productivity. Returns month-by-month productivity percentages by role. |
| modus_get_historical_attritionA | Get historical attrition metrics for trend analysis. Returns attrition rates and counts over specified time periods. |
| modus_get_sales_breakdownA | Get comprehensive sales breakdown with hiring/capacity analysis including targets, capacity, attrition impact, and quarterly waterfall metrics. Returns month-by-month capacity projections with revenue gaps and hiring needs. The period type is auto-detected: use quarter for quarterly analysis, year for annual, or startDate/endDate for custom ranges. |
| modus_get_sales_insightsA | Get AI-powered sales insights across 30+ categories including revenue gaps, attrition risk, territory performance, pipeline coverage, and competitive analysis. Returns detailed insights with recommendations and confidence scores. |
| modus_get_benchmark_insightsA | Get benchmark-driven sales insights with company data and industry comparisons. Optimized for fast retrieval (< 500ms) with multi-layer caching. Returns insights with company metrics (OTE, quotas, attrition rates), industry benchmarks with sources, variance analysis, and actionable recommendations. Use this for comparing your company's metrics to industry standards. |
| modus_get_hiring_timelineB | Get planned hiring timeline with ramp details and quota assignments. Returns hiring schedule with time to hire, start/end dates, territory assignments, monthly ramp percentages, and quarterly quotas. |
| modus_get_performance_leaderboardA | Get top sales performers across key metrics including opportunities created/won, pipeline created, bookings, ASP, and close rate. Returns ranked list of top performers for each metric. |
| modus_get_team_performanceB | Get team performance overview with performance labels (Top performer, High potential, At risk, etc.). Returns employee performance metrics including revenue, bookings, opportunities, pipeline, ASP, and close rate. |
| modus_get_employee_insightsA | Get individual employee performance insights with AI analysis. Returns detailed performance summary including ramp progress, quota attainment, revenue, pipeline coverage, and AI-generated insights about performance trends and concerns. |
| modus_get_quota_assignmentsA | Get quota assignments by employee and territory. Returns employee quota assignments with quarterly and annual quotas, territory details, and regional breakdowns. |
| modus_get_quarterly_capacityA | Get quarterly capacity breakdown showing beginning/end capacity, revenue targets, gaps, attrition impact, backfills, and capacity at risk. Returns 5 quarters (3 previous + current + 1 future) with detailed waterfall metrics. This is the PREFERRED tool for revenue gap analysis. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Each tool targets a distinct aspect of sales and HR analytics, such as attrition risks, benchmarks, headcount, individual performance, and team performance. The descriptions clearly differentiate them, with no overlapping purposes.
All tools follow a consistent 'modus_get_' prefix with descriptive snake_case nouns (e.g., attrition_risks, benchmark_insights). No variation in naming convention.
14 tools is well-scoped for a comprehensive sales and HR analytics server, covering various metrics and insights without being excessive or sparse.
The set covers a wide range of read-only analytics needs, but lacks any write or configuration tools (e.g., to update data or set parameters), which might be expected for full lifecycle support.