# AskNicely MCP > AskNicely MCP manages customer experience and Net Promoter Score (NPS) surveys directly through your AI agent. It lets you pull current NPS scores, review detailed feedback comments, list contacts, and trigger new surveys—all from chat. Stop jumping between dashboards just to gauge sentiment; this connects real-time CX data into your workflow. ## Overview - **Category:** business-intelligence - **Price:** Free - **Tags:** nps-tracking, customer-feedback, sentiment-analysis, survey-automation, customer-satisfaction ## Description Tracking customer satisfaction shouldn't require manual dashboard exports or endless clicking through reports. This MCP gives your AI agent a direct line into your Net Promoter Score (NPS) platform. You can ask questions like, 'What was the average sentiment score for last month?' and get an immediate answer. Need to follow up on a specific customer? Your agent can list contacts or even trigger a survey right from the chat window. It pulls together aggregate stats—like your overall NPS score—and detailed feedback records so you can spot trends and pain points instantly. Connecting this capability through Vinkius means your AI client treats it like just another tool in its belt, allowing you to analyze sentiment as part of any natural conversation. It’s about getting instant summaries of metrics without ever opening a web browser. You get the data on user comments, the scores, and who was surveyed last. ## Tools ### get_account_check Verifies that the AskNicely account is connected and working correctly. ### get_statistics Retrieves a summary of your overall Net Promoter Score (NPS) metrics. ### list_contacts Provides a complete list of all contacts stored in your AskNicely account. ### list_responses Retrieves specific survey results, including scores and comments for various customers. ### trigger_survey Adds a new contact to your system and immediately initiates an NPS survey for them. ## Prompt Examples **Prompt:** ``` Show me our current NPS statistics. ``` **Response:** ``` Your current Net Promoter Score is 72. You have 85 promoters, 10 passives, and 5 detractors in the last 30 days. ``` **Prompt:** ``` List the last 5 survey responses with comments. ``` **Response:** ``` I've retrieved the latest responses. The most recent comment from 'John Doe' says: 'Love the new interface, very intuitive!' with a score of 10. ``` **Prompt:** ``` Trigger an NPS survey for 'Jane Smith' at 'jane@example.com'. ``` **Response:** ``` The survey for Jane Smith (jane@example.com) has been successfully triggered and she has been added to your contacts. ``` ## Capabilities ### Gauge current customer sentiment Retrieves your aggregate NPS statistics and tracks how overall customer sentiment is changing over time. ### Audit detailed feedback records Accesses specific survey responses, including both the numeric scores and the written comments from customers. ### Manage user lists Provides a full list of contacts in your account, letting you track when users were last surveyed or engaged with the product. ### Automate feedback collection Sends an immediate survey to a specific contact directly from your chat interface so you can capture fresh feedback. ## Use Cases ### The Product Manager needs to measure impact after a feature launch. A PM asks their agent: 'What did users say about the new dashboard this month?' The agent uses `list_responses` and summarizes comments, telling the PM exactly where sentiment dipped and why. No more manual data wrangling. ### The CSM needs to re-engage a dormant account. A CSM realizes an important client hasn't been surveyed in six months. They instruct their agent to run `list_contacts` to verify the user and then use `trigger_survey` to send a fresh NPS request. ### The Marketing team needs testimonial ideas. A marketer asks for all 'promoters' (score 9-10) from the last quarter. The agent pulls this list via `list_responses`, giving them immediate, actionable leads for case studies. ### The Executive needs a quick health check on CX. An executive asks: 'What's our current NPS score and how has it changed?' The agent immediately calls `get_statistics` and reports the trend, giving an instant snapshot of company health. ## Benefits - **Gauge overall sentiment instantly.** Instead of exporting a spreadsheet just to find the average NPS, your agent calls `get_statistics` and gives you the number immediately. This saves time and keeps you in one window. - **Deep dive on specific accounts.** You can ask for all responses from a particular segment or account. The MCP lets you use `list_responses` to pull up detailed records so you aren't guessing where the pain points are. - **Automate follow-up surveys.** Found a key contact who hasn't been surveyed in months? Use the MCP to trigger a survey right away using `trigger_survey`, making sure your feedback loop never breaks. - **Keep track of everyone you talk to.** Need to know when John Doe was last asked about his experience? Run `list_contacts` to audit your entire database and see who needs attention. - **Audit connections with certainty.** Before relying on the data, run `get_account_check`. This confirms everything is authenticated and working so you don't waste time running useless prompts. ## How It Works The bottom line is that your AI client handles all the back-and-forth with the platform's API so you get clean answers right where you are working. 1. First, ensure the MCP has verified connection credentials via `get_account_check`. 2. Next, prompt your agent to perform an action, such as listing contacts or getting overall statistics using `get_statistics`. 3. Finally, the agent pulls the relevant data (like a list of responses via `list_responses`) and presents it to you in plain text. ## Frequently Asked Questions **How do I check my overall NPS score using get_statistics?** You simply ask your agent to retrieve the aggregate statistics. The MCP runs `get_statistics` and reports the current score, along with summaries of promoters, passives, and detractors. **Can I use list_responses to find out what a customer said?** Yes. Running `list_responses` pulls up specific survey submissions. You can filter these records by date or score to find the exact comments you need for product feedback. **What is the purpose of list_contacts in AskNicely MCP?** This tool runs `list_contacts` and gives you a master list of everyone in your system. You can use this to audit who has been surveyed or if an account needs updating. **How do I send a survey using trigger_survey?** You ask the agent to run `trigger_survey` for a specific email address. It handles adding that person as a contact and sending the fresh NPS request immediately. **How do I confirm my connection settings using get_account_check?** This tool validates your API key and access rights immediately. Running this first step ensures the MCP can talk to AskNicely before you run any complex queries, preventing wasted time and unexpected errors later. **When I use list_responses, what specific fields should I expect in the data output?** The results give you the respondent's ID, the score they gave (1-10), and the full text comment. This structured data makes it simple for your AI agent to analyze sentiment or pull out specific pieces of information programmatically. **What should I do if the get_statistics call fails due to rate limits?** You need to build a retry mechanism with exponential backoff. The MCP documentation specifies the exact error code and recommended wait time when hitting usage caps, letting your agent handle temporary service outages gracefully. **Can I automate sending surveys to a list of people using list_contacts and trigger_survey?** Yes. First, run list_contacts to pull all the necessary emails or IDs. Then, you loop through that resulting list, calling trigger_survey for each specific contact ID you want to prompt immediately. **How do I find my AskNicely API Key?** Log in to your AskNicely account, go to **Settings > API**, and you will find your API Key listed there. Copy it and paste it below. **What is the 'domain' in AskNicely?** The domain is your AskNicely subdomain (e.g., if your URL is `mycompany.asknice.ly`, your domain is `mycompany`). **Can I trigger a survey for a new customer?** Yes, use the `trigger_survey` tool and provide the customer's name and email. This will add them to your contacts and send the survey immediately.