# Nicereply MCP > Nicereply MCP Server lets your agent access deep customer data without opening a browser tab. You can list all surveys, get CSAT/NPS metrics for specific reports, and inspect individual feedback responses or user profiles using tools like `list_surveys` and `get_survey_stats`. It turns dashboard analysis into natural conversation. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** csat, nps, customer-feedback, survey-analytics, agent-performance, customer-satisfaction ## Description Listen up. This isn't just another dashboard view. The Nicereply MCP Server hooks your customer satisfaction data right into your conversation, letting your agent access metrics usually locked deep in a browser tab. It turns dry analysis into natural chat. **Survey Performance and Metrics** To start checking performance, you gotta use `list_surveys`, which gives you a complete rundown of every survey setup configured in your account. If you need specifics on one particular type, you can call `get_survey` to pull all the detailed info about that specific survey. Getting numbers is easy with `get_survey_stats`; this tool pulls aggregated statistics—like CSAT or NPS scores—for any given survey type or timeframe you specify. Don't forget your rating scale; if you need to know what values are possible, `get_rating_values` lists all the rating scales and options used across your surveys. **Feedback Deep Dive** Want to see what people are actually saying? You start by listing recent responses using `list_responses`, which streams a list of customer feedback records, showing you who rated and when they did it. If one response looks interesting, you grab the full metadata—the actual text and context—by calling `get_response` with its unique ID. This lets your agent inspect that single piece of feedback in real time. **Customer and Agent Tracking** Need to know who's talking or who's working? You can get a list of every customer tracked by running `list_customers`. If you need deep background on one person, `get_customer` pulls detailed data for that specific profile, including their entire history of submitted feedback patterns. For the team side of things, run `list_users` to see every agent or workspace user who submits ratings. You can also check your own operational details by calling `get_me`. If you need to know about a specific person's input, you can get individual rating scores for those users. **How It Works in the Chat** When you connect this server, your AI client handles everything. You don't write API calls; you just ask questions like, 'What was our NPS score last month?' Your agent automatically uses `get_survey_stats` and spits the clean number right back into the conversation stream. It keeps the data flow moving without forcing anyone to jump between tabs or open a browser window. You use these tools to analyze patterns, track history, and get numbers instantly. ## Tools ### get_customer Retrieves detailed data for one specific customer profile. ### get_me Fetches the current user's operational details within Nicereply. ### get_rating_values Lists all possible rating values and scales used across your surveys. ### get_response Gets the full content and metadata for a single customer feedback response using its ID. ### get_survey_stats Pulls aggregated statistics, like CSAT or NPS scores, for a given survey type. ### get_survey Retrieves detailed information about one specific survey setup. ### list_customers Provides a list of all customers tracked in the Nicereply system. ### list_responses Lists recent customer feedback responses, allowing you to see who rated and when. ### list_surveys Gives a list of all surveys configured in your account. ### list_users Lists every agent or workspace user who submits feedback or ratings. ## Prompt Examples **Prompt:** ``` Show me the latest customer feedback responses. ``` **Response:** ``` I've retrieved the recent responses. You have 5 new ratings: 4 'Great' and 1 'Neutral'. The neutral feedback mentioned 'Slow response time' from a ticket yesterday. Would you like the full details for that response? ``` **Prompt:** ``` What is the current performance of our CSAT survey? ``` **Response:** ``` Fetching CSAT survey stats... Your current CSAT score is 92%, based on 156 responses this month. This is a 2% increase compared to last month. Shall I provide a breakdown of the scores? ``` **Prompt:** ``` List all active surveys in my Nicereply account. ``` **Response:** ``` Retrieving surveys... You have 3 active surveys: 'Post-Ticket CSAT' (ID: srv_123), 'Product Feedback NPS' (ID: srv_456), and 'Onboarding CES'. Which one would you like more information about? ``` ## Capabilities ### Get Customer Details Retrieves specific customer profiles, including their historical feedback patterns. ### List All Active Surveys Pulls a list of every active survey set up in your Nicereply account. ### Calculate Survey Metrics (CSAT/NPS) Fetches detailed, aggregate statistics for any selected survey type or timeframe. ### List Feedback Responses Streams a list of recent customer responses and feedback records. ### Inspect Specific Feedback Grabs the full metadata for one specific response or survey using its unique ID. ### Track Agent Performance Lists workspace users and provides individual ratings or feedback scores for team members. ## Use Cases ### Spotting a bad trend after launch A Product Manager needs to know if the new dashboard broke something. Instead of manually running reports in the web UI, they ask their agent to run `get_survey_stats` for the 'Post-Feature Rollout' survey. The agent immediately returns the current CSAT score and flags a 10% drop since yesterday. ### Reviewing an account after support A CSM needs to follow up with a top client, Acme Corp. They ask their agent to run `get_customer` on Acme's ID. The agent returns the profile and shows that Acme hasn't submitted feedback in 90 days, prompting the CSM to schedule an immediate check-in. ### Daily team performance review A Support Lead starts a standup by asking their agent to run `list_users` and then fetch ratings for each user. The agent compiles the list, quickly showing which agents need coaching on tone or follow-up steps. ### Debugging confusing feedback A PM gets a vague complaint email. They ask their agent to find related data using `list_responses` and then use `get_response` on the ID of the most recent entry. This provides the full context: which survey it came from, and exactly when. ## Benefits - Stop hunting through dashboards. Use `get_survey_stats` to get a clean, direct score (CSAT/NPS) for any survey without clicking through multiple tabs or filtering dates manually. - Instantly see who's talking. Running `list_responses` gives you a real-time feed of the latest feedback and ratings, letting you spot negative trends seconds after they happen. - Track agent quality easily. With `list_users`, you can pull up an agent’s individual rating score or view their history to benchmark performance during sync meetings. - Deep dive on specific cases. If a customer mentions an issue, use `get_response` with the ID to grab all related metadata—the timestamp, the survey type, and the full text. - Analyze relationships quickly. You can pair tools: first run `list_customers`, then use `get_customer` on one of those IDs to see their complete feedback history. ## How It Works The bottom line is: you get structured customer data directly into the chat window without leaving your workflow. 1. Subscribe to the Nicereply server on Vinkius. 2. Plug in your private API key (the credential). 3. Ask your AI client a question—like, 'What was our CSAT score last week?'—and it executes `get_survey_stats`. ## Frequently Asked Questions **How do I list surveys using the Nicereply MCP Server?** Use `list_surveys` to retrieve a full list of all active survey names and IDs in your account. This is always step one if you aren't sure which survey metrics you need. **Can I get the CSAT score without knowing the Survey ID? (get_survey_stats)** You generally need to know the survey name or type. First, run `list_surveys` to find the exact name, then use that in your prompt for `get_survey_stats`. **What is the difference between list_responses and get_response?** `list_responses` gives you a feed of recent responses (a summary). Use `get_response` when you have a specific ID and need to pull all the detailed metadata for that single piece of feedback. **How do I check agent performance with list_users?** Run `list_users` first. This provides the roster of agents. Then, you can follow up by asking to see their specific rating scores using the names returned in that list. **What does get_rating_values do? (get_rating_values)** `get_rating_values` shows you what numbers or text options are valid for ratings across your surveys. It prevents you from requesting a score that doesn't exist in the system. **When I use `list_customers`, how do I confirm my API key has permission to read all customer data?** The system confirms access via a successful call. If you get an authentication error, the scope of your private key is too limited for that action. Check your Nicereply developer settings for necessary permissions. **If I run `get_response` with an ID that doesn't match any record, what kind of message should I expect?** You will receive a 404 or similar 'Not Found' error. This means the specific response ID you provided either never existed or your agent simply doesn't have access to it. **Does `get_customer` give me insight into that user’s overall feedback history?** Yes, running `get_customer` pulls the profile details but also links to a summary of their historical interactions. This helps you see patterns across multiple survey submissions. **Where do I find my Nicereply API Key?** Log in to Nicereply, go to Settings > API and Integrations, and you will find your 'Private API Key' there. **Does this support NPS surveys?** Yes! Nicereply supports CSAT, CES, and NPS. You can list all your surveys using the `list_surveys` tool and get stats for any of them. **Can I see feedback for a specific support agent?** You can use the `list_users` tool to find the Agent ID and then filter responses or view individual ratings recorded in the platform.