Skip to content

MCP Tools Reference

Complete reference for every tool and guided prompt on the FeedbackPulse MCP server (https://app.feedbackpulse.com/mcp). For setup instructions, see AI Assistants & MCP.

ToolWhat it returnsScopeRole
list_surveysSurveys with status, response rate, and schedule. Filters: status (active, completed, expired, scheduled, draft, cancelled, archived). Cursor pagination.mcp:useAdmin, Manager
get_survey_detailMetadata for one survey: status, anonymity, response rate, template type, AI summary availability. Requires survey_id.mcp:useAdmin, Manager
get_survey_resultsPer-question aggregates — Likert averages, eNPS scores with promoter/passive/detractor breakdown, benchmark context, previous/year-ago eNPS deltas when available, yes/no percentages, text responses (up to 50). Anonymous surveys suppress text responses below the privacy threshold.mcp:useAdmin, Manager
get_survey_summaryAI-generated summary with themes and insights from text responses. Requires survey_id.mcp:useAdmin, Manager
list_survey_templatesTemplates with name, type, and question count. Filter by type. Cursor pagination.mcp:useAdmin only
get_survey_templateFull template including all questions, types, and display options. Use before updating. Requires survey_template_id.mcp:useAdmin only
create_survey_templateCreates a new template. Supports question types: likert, yes_no, text, enps. Template types: pulse, onboarding, exit_interview, enps, leadership, engagement, custom. No survey is launched.mcp:writeAdmin only
update_survey_templateUpdates a template’s name, description, anonymity, type, or questions. Providing a questions array replaces all existing questions. Previously launched surveys are not affected.mcp:writeAdmin only
ToolWhat it returnsScopeRolePlan
list_review_cyclesReview cycles with completion statistics for performance and peer reviews. Use to find cycle IDs.mcp:useAdmin, ManagerAny
get_review_cycle_summaryDepartment-by-department breakdown: completed, in-progress, not-started, and overdue counts. Requires review_cycle_id.mcp:useAdmin, ManagerAny
list_perf_reviewsPer-employee performance review status. Defaults to the active cycle. Filters: status (completed, in_progress, not_started, overdue), department, search, employee_id. Managers see their reports only.mcp:useAdmin, ManagerPaid
list_peer_reviewsPeer reviews with status. Anonymous reviewers hidden. Filters: review_cycle_id, status. Cursor pagination.mcp:useAdmin, ManagerAny
get_peer_review_statsAggregate stats: completion rate, average ratings, overdue count. Requires review_cycle_id.mcp:useAdmin, ManagerAny
ToolWhat it returnsScopeRolePlan
get_recognition_statsAggregate metrics: total count, this-month count, kudos vs constructive breakdown, top 5 recipients. Filters: type (kudos, constructive), department, period (today, 7days, 30days, quarter) or custom from/to dates, recipient_id.mcp:useAdmin, ManagerPaid
list_recognitionsIndividual recognition records with feedback text. Anonymous submitters hidden. Admins see pending recognitions; Managers see approved only. Same filters as get_recognition_stats. Cursor pagination.mcp:useAdmin, ManagerPaid
ToolWhat it returnsScopeRole
list_employeesEmployees with name, email, job title, department, status, and manager. Filters: status (active, terminated, invited, not-invited), department (exact match), search (name, email, or title partial match). Managers see direct and indirect reports only. Cursor pagination.mcp:useAdmin, Manager

Guided prompts provide structured, multi-step workflows. To run a prompt, ask your AI assistant by name, for example: “Run the team pulse for the Engineering department.”

Analyses recent surveys for a team or the whole organisation. Retrieves results and AI summaries, identifies low-scoring questions, and produces actionable recommendations.

ArgumentRequiredDescription
survey_idNoAnalyse a specific survey. If provided, department and period are ignored.
departmentNoFilter to a specific department.
periodNoLook-back window, e.g. “last 90 days”. Defaults to last 90 days.

Full engagement snapshot combining survey scores and recognition activity. Flags low-response or high-concern areas and recommends next actions.

ArgumentRequiredDescription
departmentNoScope to one department.
periodNoTime window to analyse. Defaults to last 90 days.

Pre-review compilation: cycle completion status, peer feedback stats, and calibration notes. Requires performance reviews to be enabled on your plan.

ArgumentRequiredDescription
review_cycleYesCycle name or ID. Use list_review_cycles to find available cycles.
employee_nameNoNarrow the prep to a single employee.

Quick health check on a team’s survey participation and recognition frequency. Works by department or manager name.

ArgumentRequiredDescription
departmentNoDepartment name.
manager_nameNoManager name to scope the check to their team.
periodNoTime window to analyse. Defaults to last 90 days.
RoleSurveysReviewsRecognitionsEmployeesTemplate write
AdminAll org dataAll reviewsAll (including pending)All employeesYes (mcp:write)
ManagerAll org dataDirect/indirect reportsApproved onlyDirect/indirect reportsNo
EmployeeNo accessNo accessNo accessNo accessNo

← Back to MCP Overview