FeedbackPulse 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.

Survey tools

Note

Surveys are report-gated in FeedbackPulse: only Admins can view survey reports through MCP. Managers do not have survey reporting access through MCP at all, even for their own direct or indirect reports.

Tool	What it returns	Scope	Role
list_surveys	Surveys with status, response rate, and schedule. Filters: status (active, completed, expired, scheduled, draft, cancelled, archived). Cursor pagination.	mcp:use	Admin only
get_survey_detail	Metadata for one survey: status, anonymity, response rate, template type, AI summary availability. Requires survey_id.	mcp:use	Admin only
get_survey_results	Per-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:use	Admin only
get_survey_summary	AI-generated summary with themes and insights from text responses. Requires survey_id.	mcp:use	Admin only
create_survey_draft	Creates a real, unlaunched draft survey from an existing template and returns a dashboard edit link. Does not launch the survey, finalize scheduling, snapshot questions, or notify employees. Requires template_id and name.	mcp:write	Admin only
list_survey_templates	Templates with name, type, and question count. Filter by type. Cursor pagination.	mcp:use	Admin only
get_survey_template	Full template including all questions, types, and display options. Use before updating. Requires survey_template_id.	mcp:use	Admin only
create_survey_template	Creates 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:write	Admin only
update_survey_template	Updates a template’s name, description, anonymity, type, or questions. Providing a questions array replaces all existing questions. Previously launched surveys are not affected.	mcp:write	Admin only

Review tools

Tool	What it returns	Scope	Role	Plan
list_review_cycles	Review cycles with completion statistics for performance and peer reviews. Use to find cycle IDs.	mcp:use	Admin, Manager	Any
get_review_cycle_summary	Department-by-department breakdown: completed, in-progress, not-started, and overdue counts. Requires review_cycle_id.	mcp:use	Admin, Manager	Any
list_perf_reviews	Per-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:use	Admin, Manager	Paid
list_peer_reviews	Peer reviews with status. Anonymous reviewers hidden. Filters: review_cycle_id, status. Cursor pagination.	mcp:use	Admin, Manager	Any
get_peer_review_stats	Aggregate stats: completion rate, average ratings, overdue count. Requires review_cycle_id.	mcp:use	Admin, Manager	Any

Note

list_perf_reviews returns an error if performance reviews are not enabled on your plan.

Recognition tools

Note

Recognitions are also report-gated: only Admins can view recognition data through MCP. Managers do not have recognition reporting access through MCP at all.

Tool	What it returns	Scope	Role	Plan
get_recognition_stats	Aggregate 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:use	Admin only	Paid
list_recognitions	Individual recognition records with feedback text, including pending recognitions. Anonymous submitters hidden. Same filters as get_recognition_stats. Cursor pagination.	mcp:use	Admin only	Paid

Note

Both recognition tools return an error if the Recognition feature is not enabled on your plan.

Employee tools

Tool	What it returns	Scope	Role
list_employees	Employees 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:use	Admin, Manager

Administration tools

These tools audit MCP usage itself and are available to Admins only.

Tool	What it returns	Scope	Role
list_tokens	The organisation’s MCP personal API tokens: name, owner, last four characters, and last-used/created timestamps, for the 100 most recent tokens. Token secrets are never returned. Read-only; tokens are created or revoked in Settings > Integrations.	mcp:use	Admin only
get_activity_log	The organisation’s MCP audit trail: tool name, arguments, calling user, response status, duration, and timestamp, newest first. Includes the calling Admin’s own tool calls. Optional user_id filter. Cursor pagination.	mcp:use	Admin only

Guided prompts

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.”

analyze_survey_results

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

Argument	Required	Description
survey_id	No	Analyse a specific survey. If provided, department and period are ignored.
department	No	Filter to a specific department.
period	No	Look-back window, e.g. “last 90 days”. Defaults to last 90 days.

engagement_health_check

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

Argument	Required	Description
department	No	Scope to one department.
period	No	Time window to analyse. Defaults to last 90 days.

performance_review_prep

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

Argument	Required	Description
review_cycle	Yes	Cycle name or ID. Use list_review_cycles to find available cycles.
employee_name	No	Narrow the prep to a single employee.

team_pulse

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

Argument	Required	Description
department	No	Department name.
manager_name	No	Manager name to scope the check to their team.
period	No	Time window to analyse. Defaults to last 90 days.

Permissions summary

Role	Surveys	Reviews	Recognitions	Employees	Template/draft write	Token & activity admin
Admin	All org data	All reviews	All (including pending)	All employees	Yes (mcp:write)	Yes
Manager	No access	Direct/indirect reports	No access	Direct/indirect reports	No	No
Employee	No access	No access	No access	No access	No	No

Caution

Managers have no access to survey or recognition data through MCP, regardless of team. This is a hard denial in FeedbackPulse’s reporting permissions, not a scoped or filtered view. Review and employee data remain scoped to a Manager’s direct and indirect reports as shown above.

---

← Back to MCP Overview