# Kippy MCP > Kippy MCP connects performance management data to your AI agent. It lets you pull team OKRs, review employee appraisals, track KPIs, and generate reports from one conversation. You manage goals, monitor progress, and audit performance records without opening the original HR dashboard. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** okr-tracking, performance-management, goal-setting, team-alignment, analytics, employee-feedback ## Description Connect this MCP to your preferred client through Vinkius to manage all aspects of corporate performance tracking using natural language. Instead of navigating multiple tabs or running dozens of manual queries, you ask your agent specific questions about organizational health or individual progress. You can pull current key results, review past appraisals, and check team alignment metrics instantly. This allows managers and HR teams to generate detailed summaries and spot trends simply by asking for them. For instance, you don't have to manually compile quarterly reviews across departments. Your agent handles the data retrieval, organizing everything from specific goal tracking (`list_kpi_scores`) to general feedback entries (`list_feedback`). This keeps performance conversations focused on people and progress, not on dashboard navigation. ## Tools ### list_annual_scores Retrieves a list of historical, year-over-year performance metrics for employees. ### list_appraisals Gets records and details about formal employee performance reviews and appraisals. ### list_audit_logs Lists system activity logs to track every change made within the performance management platform. ### list_competencies Retrieves a catalog of defined skills and the current competency levels for users. ### list_feedback Lists all specific qualitative feedback entries submitted by colleagues or managers. ### list_kpi_scores Provides the current, quantified scores for defined Key Performance Indicators (KPIs). ### list_kpis Retrieves a complete list of all organizational KPIs and their definitions. ### list_notes Lists miscellaneous comments, annotations, or contextual notes attached to records. ### list_project_scores Shows the performance scores and status for specific organizational projects. ### list_projects Lists all active and completed projects within the organization's records. ### list_team_scores Pulls aggregated performance scores for defined teams or departmental units. ### list_teams Lists all official operational teams tracked within the system. ### list_users Retrieves a directory of all active users and their basic profiles. ## Prompt Examples **Prompt:** ``` Show all OKRs for Q2 and the team members falling behind. ``` **Response:** ``` Q2 OKRs: 8 objectives. 'Increase revenue 20%' (65% ✅ on track). 'Launch mobile app' (40% ⚠️ at risk). 'Hire 10 engineers' (80% ✅). Behind: 3 people. Sarah — 'Mobile app MVP' (25%, deadline May 15). Mike — 'API documentation' (30%). Lisa — 'Customer onboarding' (35%). ``` **Prompt:** ``` Show the latest performance review cycle and ratings. ``` **Response:** ``` Q1 Review Cycle: 35 employees reviewed. Completion: 92% (3 pending). Ratings: Exceptional (4), Exceeds (12), Meets (15), Below (3), Needs Improvement (1). Average: 3.4/5. Top: Sarah Chen (4.8/5), Mike Torres (4.6/5). Pending: James, Lisa, David. ``` **Prompt:** ``` Create a new goal for the Engineering team and track alignment. ``` **Response:** ``` Goal created! 'Reduce API response time to <100ms' — Team: Engineering, Owner: Sarah, Deadline: Jun 30. Key Results: 1) Optimize DB queries (0/100%). 2) Implement caching (0/100%). 3) Load testing passing (0/100%). Alignment: Maps to company OKR 'Improve platform performance'. Engineering alignment: 85% (6 of 7 goals linked). ``` ## Capabilities ### Review Annual Performance Retrieve a user's or team’s overall scores and metrics from past review cycles. ### View Goal Progress Check current Key Performance Indicators (KPIs) for the organization, specific teams, or projects. ### Audit System Activity List historical system actions and data changes to track who did what and when. ### Examine Skills Gaps Pull structured lists of required skills, competencies, and associated employee rankings. ### Generate Summary Reports Compile performance summaries and trend analyses across multiple data points in one request. ## Use Cases ### Preparing for the Annual Review The HR Director needs to compile yearly performance narratives. They ask their agent to combine data from `list_annual_scores` and `list_appraisals`. The result provides a structured document summarizing historical ratings, eliminating days of manual data compilation. ### Assessing Team Alignment A manager needs to know if the Engineering team is hitting its targets. They ask for combined scores from `list_kpi_scores` and `list_team_scores`. The agent identifies which specific KPIs are lagging, allowing the manager to intervene immediately. ### Onboarding a New Manager A new team lead needs context on historical performance. They ask the agent to check `list_feedback` and `list_notes` for their direct reports' names, getting immediate qualitative context that speeds up 1:1 meetings. ### Investigating Performance Drops An executive notices a dip in project success. They ask the agent to cross-reference `list_project_scores` with `list_competencies`. This reveals if the drop was due to lack of skill, or external factors. ## Benefits - Get immediate clarity on team standing. Instead of manually checking multiple dashboards, you can ask for `list_team_scores` and get an instant summary of current departmental health. - Track progress without the clicks. You don't need to drill down into project folders; just asking about a specific initiative lets your agent check `list_project_scores` instantly. - Audit trail access is simple. Need to know who changed what? Use `list_audit_logs` to pull system logs and track data integrity without running complex searches. - Pinpoint skill gaps fast. Accessing the `list_competencies` tool lets you see where an employee's skills fall short, linking performance issues directly to training needs. - Synthesize comprehensive reports. You can combine multiple inputs—like combining `list_appraisals` with `list_feedback`—to build a complete picture of someone’s growth trajectory. ## How It Works The bottom line is you use natural conversation to pull complex performance data into plain text. 1. Subscribe to this MCP on Vinkius. Enter your Kippy API Key, Organization ID, and Username credentials. 2. Connect the service to your AI client (Claude, Cursor, etc.). 3. Ask your agent a specific question—for example, 'What are the current scores for Q3?'—and get an immediate answer. ## Frequently Asked Questions **How do I use list_kpi_scores? ** You ask your agent to check `list_kpi_scores` and specify which KPI you want scores for. The tool retrieves the current numerical status of those key indicators. **Can Kippy MCP track team progress using list_team_scores? ** Yes, running `list_team_scores` allows your agent to pull aggregated performance data for any defined group or department in the organization. **What does list_appraisals do? ** `list_appraisals` retrieves records of formal reviews and appraisals. It's where you find historical ratings and structured feedback cycles. **Does list_audit_logs show user actions? ** Yes, `list_audit_logs` lists system activity logs. You can track who accessed data or made changes at any point in the platform's history. **How do I check my skills inventory using list_competencies?** It returns a roster of defined organizational skills and associated metrics. You get to see each competency's current proficiency level, along with its historical tracking data within Kippy. **What are the security limitations when I run list_feedback?** Access is governed by your organization's permission settings. The tool only retrieves feedback entries that match your specific user role and scope permissions set up in Kippy. **How can I find out who is active using list_users?** This function returns a comprehensive list of all registered accounts. You'll see names, roles, and basic account status for every user defined within the Kippy system. **After listing projects with list_projects, how do I view their scores using list_project_scores?** You first need to get the project ID from the general list. Then, you pass that specific identifier to retrieve its current performance metrics and assigned scoring details. **Can I track OKRs and goal progress?** Yes. Browse all objectives with key results and progress percentages. Create new goals, update progress, and track alignment across teams. **Does Kippy require multiple credentials?** Yes. Kippy requires three credentials: **API Key**, **Organisation ID**, and **Username**. All are used for authentication against `kippy-tsc.appspot.com/api`. **Can I access performance reviews and feedback?** Yes. Browse review cycles, access individual feedback and ratings, and monitor completion status across the organization.