HappyOrNot MCP server
happy-or-not.com, happyornot.github.io
Yes. HappyOrNot publishes an official MCP server at https://mcp.happy-or-not.com/mcp. It's hosted. It offers 28 tools. We last checked it on 22 Nov 2026.
Official: answers MCP requests at mcp.happy-or-not.com, on HappyOrNot's own domain happy-or-not.com. Checked 22 Nov 2026. Maintained by Stuart Brameld.
Key facts
As of 22 Nov 2026, HappyOrNot's official MCP server scores 55/100 (provisional) on MartechDB's Agent Readiness Index (v1.1). It answered 56 of our 56 checks in the last 90 days and lists 28 tools.
How the Agent Readiness Index works · Wrong? Suggest a correction
HappyOrNot MCP server review
55/100
HappyOrNot's MCP server scores 55/100 on MartechDB's Agent Readiness Index: usable by AI agents, with gaps.
The good
Hosted by HappyOrNot: connect by URL, with nothing to install
Answered 100% of our checks in the last 90 days
The bad
Nothing we've found.
Not checked yet: how you sign in; a docs page listing its tools; what agent access costs. Anything not checked scores nothing.
Official MCP server
HappyOrNot MCP server
- Address
- https://mcp.happy-or-not.com/mcp
- Runs
- Hosted
- Sign-in
- Official MCP Registry
- Not listed
- How we know it's official
-
- Answers MCP requests at mcp.happy-or-not.com, on HappyOrNot's own domain happy-or-not.com.
- Tools
- 28 tools · listed 28 Oct 2026
- First seen
- 1 Oct 2026
- Last checked
-
Reachable ·
16 Nov 2026: reachable17 Nov 2026: reachable18 Nov 2026: reachable19 Nov 2026: reachable20 Nov 2026: reachable21 Nov 2026: reachable22 Nov 2026: reachable
- Uptime
- 100% · 56 of 56 checks reachable since 1 Oct 2026
HappyOrNot MCP server tools (28)
As the server lists them. Names and descriptions are the vendor's own.
-
calculate_happy_indexCalculate the Happy Index (0-100) for 4-button or 5-button smiley feedback: the vote-weighted average button position, rescaled to 0-100 and truncated to 0 decimal places.
-
get_api_domain_glossaryReturn background on HappyOrNot domain terms (Experience Point, Group, Survey, Smiley, feedback types) referenced across this server's tools.
-
get_api_build_infoReturn the HappyOrNot API's version and build metadata, as published in its OpenAPI spec at MCP server startup: version='2.1', build_version='25afbbc', build_timestamp='2026-09-10T06:43:23Z'. Use this to identify which API build is being served and how recent it is. If the values returned by a CALL to this tool ever differ from the values stated in THIS description, your MCP client is using a stale cached tool list — re-fetch tool descriptions from the server.
-
get_mcp_build_infoReturn this MCP server's own build metadata (as opposed to the upstream HappyOrNot API's, see get_api_build_info): build_version='d920713', build_timestamp='2026-09-10T17:43:14Z'. Use this to identify which MCP server build is running and how recent it is. If the values returned by a CALL to this tool ever differ from the values stated in THIS description, your MCP client is using a stale cached tool list — re-fetch tool descriptions from the server.
-
getTokenIntrospectionReturns metadata about the provided token, including its status, ID, name, and scopes. This endpoint is only available to the token's owner. Intended for self-service token management. Returns: - token_id (integer): Unique identifier of the token. (format: int64) - token_name (string): Human-readable name of the token. - scopes (array of string): List of scopes granted to the token. For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listButtonFeedbacksList button feedbacks that match the given parameters Returns: {"results": [...], "pagination": {"offset": int, "limit": int, "more_available": bool}}. "more_available" is true if more results exist beyond this page — re-call with offset increased by the number of results returned (or by limit) to fetch the next page. Each item in results: - feedbackId (string): (format: uuid) - smileyId (integer): (format: int64) - localTime (string): Time the feedback was given, in the time zone of the experience point in the survey (format: date-time) - surveyId (integer): (format: int64) - experiencePointId (integer): (format: int64) - buttonIndex (integer): Smaller value means more negative response. Possible values for four scale 0-3, five scale 0-4, NPS 0-10. Four scale: 0=Very Unhappy, 1=Unhappy, 2=Happy, 3=Very Happy. Five scale: 0=Very Unhappy, 1=Unhappy, 2=Neutral, 3=Happy, 4=Very Happy. NPS scale: buttonIndex is the raw NPS response value. For example, buttonIndex 3 means Very Happy on a f…
-
listFollowupFeedbacksList follow-up feedbacks that match the given parameters Returns: {"results": [...], "pagination": {"offset": int, "limit": int, "more_available": bool}}. "more_available" is true if more results exist beyond this page — re-call with offset increased by the number of results returned (or by limit) to fetch the next page. Each item in results: - feedbackId (string): (format: uuid) - smileyId (integer): (format: int64) - localTime (string): Time the feedback was given, in the time zone of the experience point in the survey (format: date-time) - surveyId (integer): (format: int64) - experiencePointId (integer): (format: int64) - buttonIndex (integer): buttonIndex that was given at button feedback phase. Available here for convenience. See details from Button Feedback docs. (range: 0-10) - misuse (boolean): If true, the feedback was deemed to be misuse - position (integer): Position in the survey flow. 0 being the first phase. (min: 0) - ui (string): (enum: physical, digital, exit, skip,…
-
listTextFeedbacksList text feedbacks that match the given parameters Returns: {"results": [...], "pagination": {"offset": int, "limit": int, "more_available": bool}}. "more_available" is true if more results exist beyond this page — re-call with offset increased by the number of results returned (or by limit) to fetch the next page. Each item in results: - feedbackId (string): (format: uuid) - smileyId (integer): (format: int64) - localTime (string): Time the feedback was given, in the time zone of the experience point in the survey (format: date-time) - surveyId (integer): (format: int64) - experiencePointId (integer): (format: int64) - buttonIndex (integer): buttonIndex that was given at button feedback phase. Available here for convenience. See details from Button Feedback docs. (range: 0-10) - misuse (boolean): If true, the feedback was deemed to be misuse - position (integer): Position in the survey flow. 0 being the first phase. (min: 0) - ui (string): (enum: physical, digital, exit, skip, timeo…
-
listDemographicsList demographics (age, gender) related to feedback that match the given parameters Returns: {"results": [...], "pagination": {"offset": int, "limit": int, "more_available": bool}}. "more_available" is true if more results exist beyond this page — re-call with offset increased by the number of results returned (or by limit) to fetch the next page. Each item in results: - feedbackId (string): (format: uuid) - smileyId (integer): (format: int64) - localTime (string): Time the feedback was given, in the time zone of the experience point in the survey (format: date-time) - surveyId (integer): (format: int64) - experiencePointId (integer): (format: int64) - buttonIndex (integer): buttonIndex that was given at button feedback phase. Available here for convenience. See details from Button Feedback docs. (range: 0-10) - misuse (boolean): If true, the feedback was deemed to be misuse - smileyType (string): (enum: SMILEY_TERMINAL, SMILEY_TOUCH, SMILEY_DIGITAL) - gender (string): (enum: male, fe…
-
listContactDetailsList contact details (name, email/phone number) related to feedback that match the given parameters Returns: {"results": [...], "pagination": {"offset": int, "limit": int, "more_available": bool}}. "more_available" is true if more results exist beyond this page — re-call with offset increased by the number of results returned (or by limit) to fetch the next page. Each item in results: - feedbackId (string): (format: uuid) - smileyId (integer): (format: int64) - localTime (string): Time the feedback was given, in the time zone of the experience point in the survey (format: date-time) - surveyId (integer): (format: int64) - experiencePointId (integer): (format: int64) - buttonIndex (integer): buttonIndex that was given at button feedback phase. Available here for convenience. See details from Button Feedback docs. (range: 0-10) - misuse (boolean): If true, the feedback was deemed to be misuse - position (integer): Position in the survey flow. 0 being the first phase. (min: 0) - smileyTy…
-
listMetadataList metadata related to feedback that match the given parameters Returns: {"results": [...], "pagination": {"offset": int, "limit": int, "more_available": bool}}. "more_available" is true if more results exist beyond this page — re-call with offset increased by the number of results returned (or by limit) to fetch the next page. Each item in results: - feedbackId (string): (format: uuid) - smileyId (integer): (format: int64) - localTime (string): Time the feedback was given, in the time zone of the experience point in the survey (format: date-time) - surveyId (integer): (format: int64) - experiencePointId (integer): (format: int64) - buttonIndex (integer): buttonIndex that was given at button feedback phase. Available here for convenience. See details from Button Feedback docs. (range: 0-10) - misuse (boolean): If true, the feedback was deemed to be misuse - smileyType (string): (enum: SMILEY_TERMINAL, SMILEY_TOUCH, SMILEY_DIGITAL) - key (string): (e.g. refId) - value (string): (e.g.…
-
getAggregatedResultsReturns feedback counts aggregated by the requested time precision and optional grouping dimensions. Feedback counts reflect the survey's scale: - **4-scale**: happy, somewhat happy, somewhat unhappy, unhappy - **5-scale**: adds a neutral midpoint - **NPS (0–10)**: counts per score value Records with `misuse=true` are excluded from aggregated results, consistent with other reporting endpoints. Experience point IDs are validated against the token's authorized set — requesting an unauthorized ID returns 403. `precision` and `grouping` cannot both be `none` — at least one of them must be set to a non-`none` value. Requesting both as `none` returns 400. Returns: Aggregated feedback counts for a single time bucket and grouping combination. - time (string): Start of the time bucket. Null when precision is `none`. (format: date-time) - groupKeys (array of string): Values for each requested grouping dimension, in the same order as the grouping path parameter. Null when grouping is `none`. Gro…
-
listExperiencePointsTree of groups and experience points in tabular format Returns: - experiencePointId (integer) - name (string) - parent (integer) - type (string): (enum: GROUP, EXPERIENCE-POINT) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listCustomDataFieldsExperience point's or tree of experience point's custom data fields in list format Returns: - experiencePointId (integer) - label (string) - value (string) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listCompanyCustomDataFieldscompany's custom data fields and labels in list format Returns: - id (string) - label (string) - type (string) - options (array of string) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listSurveysList of all surveys Returns: - surveyId (integer): (format: int64) - questionId (integer): (format: int64) - defaultLocale (string): (pattern: ^[a-z]{2}(_[A-Z]{2})?$, e.g. en_US) - questionTextInDefaultLocale (string): (e.g. How was the service?) - surveyType (string): (enum: CUSTOMER, EMPLOYEE) - feedbackScale (string): (enum: four, five, five_reversed, nps) - indexType (string): (enum: HAPPY, NPS, NPS_OFFICIAL, AVERAGE) - state (string): (enum: active, ended, upcoming) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listSurveyExperiencePointIdsReturns the experience point IDs used by the given survey. Only experience points the token is authorized for are considered: if none of the survey's experience points overlap with the token's authorized set, the survey doesn't exist, or it belongs to another company, the endpoint returns 404. For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listQuestionsList of all questions Returns: - questionId (integer): (format: int64) - defaultLocale (string): (pattern: ^[a-z]{2}(_[A-Z]{2})?$, e.g. en_US) - questionTextInDefaultLocale (string): (e.g. How was the service?) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listQuestionLocalizationsList of all question localizations Returns: - questionId (integer): (format: int64) - locale (string): (pattern: ^[a-z]{2}(_[A-Z]{2})?$, e.g. en_US) - text (string): (e.g. How was the service?) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listFollowupQuestionsList of all follow-up questions Returns: - followupQuestionId (integer): (format: int64) - surveyId (integer): (format: int64) - positive (boolean) - questionTextInDefaultLocale (string): NOTE! This might be empty if default locale has been changed (e.g. What was particularly good?) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listFollowupQuestionLocalizationsList of all follow-up question localizations Returns: - followupQuestionId (integer): (format: int64) - locale (string): (pattern: ^[a-z]{2}(_[A-Z]{2})?$, e.g. en_US) - text (string) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listFollowupOptionsList of all follow-up options Returns: - followupOptionId (integer): (format: int64) - followupQuestionId (integer): (format: int64) - optionTextInDefaultLocale (string): NOTE! This might be empty if default locale has been changed For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listFollowupOptionLocalizationsList of all follow-up option localizations Returns: - followupOptionId (integer): (format: int64) - locale (string): (pattern: ^[a-z]{2}(_[A-Z]{2})?$, e.g. en_US) - text (string) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listAlertsList of all alerts Returns: {"results": [...], "pagination": {"offset": int, "limit": int, "more_available": bool}}. "more_available" is true if more results exist beyond this page — re-call with offset increased by the number of results returned (or by limit) to fetch the next page. Each item in results: - alertId (integer): (format: int64) - alertSpecificationId (integer): (format: int64) - surveyId (integer): (format: int64) - experiencePointId (integer): (format: int64) - beginTime (string): Time when alert was triggered, in experience point's local time (format: date-time) - endTime (string): Time when alert was closed, in experience point's local time. If empty, alert is still open. (format: date-time) - alertSpecificationType (string): (enum: negative, feedbackCount, indexThreshold) - parameters (string): (pattern: ^(\w+=[\w,]*)( \w+=[\w,]*)*$, e.g. key1=value1 key2=value2 key3=value3a,value3b) - acknowledged (boolean): Is the alert acknowledged or not - acknowledgedByUserId (i…
-
listAlertCommentsList of all alert comments Returns: {"results": [...], "pagination": {"offset": int, "limit": int, "more_available": bool}}. "more_available" is true if more results exist beyond this page — re-call with offset increased by the number of results returned (or by limit) to fetch the next page. Each item in results: - alertCommentId (integer): (format: int64) - alertId (integer): (format: int64) - userId (integer): (format: int64) - time (string): (format: date-time) - comment (string) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listAlertSpecificationsList of all alert specifications Returns: - alertSpecificationId (integer): (format: int64) - surveyId (integer): (format: int64) - experiencePointId (integer): (format: int64) - alertSpecificationType (string): (enum: negative, feedbackCount, indexThreshold) - parameters (string): (pattern: ^(\w+=[\w,]*)( \w+=[\w,]*)*$, e.g. key1=value1 key2=value2 key3=value3a,value3b) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listUsersList of all users Returns: - userId (integer): (format: int64) - email (string): (format: email, e.g. [email protected]) - firstName (string): (e.g. Jane) - lastName (string): (e.g. Doe) - rootExperiencePointId (integer): (format: int64) - role (string): (enum: USER, ADMIN, PARTNER) - locale (string): (pattern: ^[a-z]{2}(_[A-Z]{2})?$, e.g. en_US) - loginAllowed (boolean): Is user allowed to log in - loginMethod (string): (enum: EMAIL_PASSWORD, SINGLE_SIGN_ON) - lastLogin (string): Time in UTC of user's last login (format: date-time) - created (string): Time in UTC when user was created (format: date-time) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
-
listSmileysList of all smileys Returns: - smileyId (integer): (format: int64) - name (string) - serialNumber (string) - token (string) - smileyType (string): (enum: SMILEY_TERMINAL, SMILEY_TOUCH, SMILEY_DIGITAL) For background on domain terms (Experience Point, Group, Survey, Smiley, feedback types), call get_api_domain_glossary.
Connect your AI to HappyOrNot
Add the official HappyOrNot MCP server to Claude, ChatGPT or your editor.
Connect HappyOrNot MCP to Claude
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it HappyOrNot, paste the address below and click Add.
Connect HappyOrNot MCP to ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it HappyOrNot and paste the address below.
ChatGPT usually only connects to servers with self-serve sign-in or none.
Connect HappyOrNot MCP to Cursor
Opens Cursor if it's installed. If nothing happens, use the JSON below.
Connect HappyOrNot MCP to VS Code
Opens VS Code if it's installed. Otherwise add the JSON settings from the Cursor tab to your .vscode/mcp.json.
HappyOrNot MCP server questions
Does HappyOrNot have an official MCP server?
Yes. HappyOrNot publishes its MCP server itself. Its address is on HappyOrNot's own domain (mcp.happy-or-not.com). MartechDB only lists servers a vendor publishes, never community copies.
What is the HappyOrNot MCP server URL?
The address is https://mcp.happy-or-not.com/mcp.
How do I connect HappyOrNot MCP to Claude, ChatGPT or Cursor?
In Claude, add https://mcp.happy-or-not.com/mcp as a custom connector (Customize, Connectors, Add custom connector). In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http happyornot https://mcp.happy-or-not.com/mcp
What can the HappyOrNot MCP server do?
It offers 28 tools, including calculate_happy_index, get_api_domain_glossary, get_api_build_info, get_mcp_build_info and getTokenIntrospection (as listed on 28 Oct 2026).
Is the HappyOrNot MCP server in the official MCP Registry?
No. HappyOrNot hasn't published it to the official MCP Registry.
Is the HappyOrNot MCP server working?
Yes. It answered our most recent check. We last checked it on 22 Nov 2026.
What are the alternatives to HappyOrNot's MCP server?
In Forms & surveys, the most agent-friendly alternatives with an official MCP server are Zonka (98/100), Formswrite (97/100), MetaSurvey (97/100), uplup (95/100) and Usecollect (94/100). HappyOrNot scores 55/100 on the same index.
Alternatives to HappyOrNot's MCP server
Vendors in Forms & surveys with an official MCP server, the most agent-friendly first. HappyOrNot scores 55/100.
Zonka
zonkafeedback.com
Formswrite
formswrite.com
MetaSurvey
getmetasurvey.com
uplup
uplup.com
Usecollect
usecollect.com
Use with AI
Connect your AI to MartechDB
Then ask it about HappyOrNot, or any of the 1,851 marketing tools with an official MCP server. Free, no sign-in.
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it MartechDB, paste the address below and click Add. There's no sign-in.
The free plan allows one custom connector. On Team and Enterprise plans, an owner adds the connector first.
Claude Code
Run this in your terminal:
ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it MartechDB, paste the address below and choose No authentication.
Developer mode is on Plus and Pro plans, and on Business, Enterprise and Edu if an admin allows it.
API
The same data as JSON, with no sign-in. See the OpenAPI description for every endpoint and field.
CLI
Search the directory and print the command to connect a vendor's server, from your terminal. Needs Node 18 or later. View on npm
Show that your MCP server is verified
If you work at HappyOrNot, add this badge to your MCP docs or README. It's free, it's the same for every vendor, and it updates from our daily checks: it shows uptime while the server responds, and says so if it stops.
Something wrong or out of date? Suggest a correction or email us, and we'll check it against the evidence. Every correction we make is listed on Corrections.