Skip to content
Book a Demo

FeedbackPulse MCP

FeedbackPulse provides a workspace MCP server for HR workflows and an Employee Surveys server for designing surveys. For client setup, see AI Assistants & MCP.

Server Endpoint OAuth protected resource metadata
FeedbackPulse https://app.feedbackpulse.com/mcp Discovery document
Employee Surveys https://app.feedbackpulse.com/mcp/employee-surveys Discovery document

Use the authorization server advertised in the discovery document. Both servers use authorization code with PKCE (S256).

  • FeedbackPulse workspace server. OAuth grants mcp:use. Admin write tools require a personal MCP token with mcp:write. Tool access also depends on the user’s role and the organization’s MCP settings.
  • Employee Surveys server. Preview a survey design before signing in. Saving an approved survey template or unlaunched draft requires OAuth with survey-design:persist.

Use tools/list to retrieve the server’s current input schemas. The tool tables below describe workflows and access requirements.

Tool When to call it
preview_survey Validate a complete English survey proposal and return the preview for the user to review.
prepare_survey_save Request a save receipt after the user approves the exact preview and chooses a template or unlaunched draft.
save_survey Save the approved design using the receipt after the user signs in and authorizes the connection.

The remaining tools and guided prompts are for the FeedbackPulse workspace server.

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
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
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
get_recognition Full plain text for one recognition. Requires the id returned by list_recognitions. mcp:use Admin only Paid
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

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

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.

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.

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.

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

← Back to MCP Overview