YaniFend MCP Server

Manage your YaniFend feedback questionary and read collected answers directly from Claude (Desktop, Code, or claude.ai) via the Model Context Protocol.

YaniFend is a drop-in feedback widget that lets visitors leave structured feedback on any website — a single script tag, no framework required (custom sites, SPAs, WordPress, and more). This MCP server lets an LLM client work with the YaniFend backoffice on behalf of a logged-in site owner — list personages, manage questions, and pull in collected answers — without leaving the chat.

Recommended: hosted endpoint

https://app.yanifend.com/mcp

Streamable HTTP transport, OAuth 2.1 (PKCE + RFC 7591 Dynamic Client Registration). No pre-registration — Claude Desktop / claude.ai auto-register on first connect, then prompt you to log in to YaniFend (Google / GitHub / Facebook / LinkedIn / email).

Claude Desktop / claude.ai

Add a custom connector:

• Name: YaniFend
• URL: https://app.yanifend.com/mcp

Claude Code

claude mcp add --transport http yanifend https://app.yanifend.com/mcp

Alternative: desktop extension / local stdio proxy (this repo)

This repository ships a stdio MCP server that proxies to the hosted endpoint. Configure it with your YaniFend account email + password (via the desktop-extension settings, or the YANIFEND_EMAIL / YANIFEND_PASSWORD env vars) and it signs in over HTTPS and forwards every tool call to https://app.yanifend.com/mcp — same 33 tools, same schemas and annotations, strictly scoped to your own account. Without credentials it still serves the tool catalog for registry introspection and returns a configuration hint on any call.

npx -y yanifend-mcp
# or
docker build -t yanifend-mcp . && docker run --rm -i yanifend-mcp

As a Claude Desktop extension: install the .mcpb bundle (built with npx @anthropic-ai/mcpb pack), then enter your YaniFend email and password in the extension settings. The password is stored by Claude Desktop's OS keychain and is only ever sent to app.yanifend.com.

Tools

Personages & integration

Tool	What it does
list_personages	List the feedback personages on the connected YaniFend site
create_personage	Create a new personage = a new questionary + character + embeddable API key (plan-limited)
get_company_profile	Read company profile + plan limits (personages used / allowed)
get_allowed_domains	Read the widget's allowed domains (CORS) + how to add one
list_integration_keys	API key + ready-to-paste embed snippet for every personage
get_embed_snippet	Embed snippet (key + <script> tag) for one personage

Questionary authoring

Tool	What it does
list_questions	Read the current questionary
create_question	Add a question (incl. RATE scale + icon); auto-wires an animation
update_question	Edit a question's text, type, order, or RATE config
delete_question	Remove a question
list_question_options	List options for a choice-style question
create_question_option	Add an option (CONTINUE / CLOSE / NOTIFY_MANAGER / GOTO_QUESTION; optional position)
update_question_option	Edit an option
delete_question_option	Remove an option
reorder_question_options	Reorder options without delete/recreate
clone_questionary	Copy all questions + options from one personage onto another in one call

Answers & hosted forms

Tool	What it does
list_answers	Pull the latest collected answers
list_hosted_forms	List shareable /f/{slug} feedback pages (no embed, no CORS)
create_hosted_form	Create a shareable hosted form for a personage

Notifications (hosted endpoint + authenticated proxy)

Tool	What it does
list_notification_event_types	Event types you can route (feedback submitted, low rating, …)
list_notification_channels / create_notification_channel / update_notification_channel / delete_notification_channel	Manage delivery channels (Telegram, Slack, email, …)
list_notification_routes / set_notification_route / delete_notification_route	Wire event types to channels
list_notification_deliveries	Delivery log
send_test_notification	Fire a test message through a channel

Plus set_character / get_character (personage look), update_widget_style, and delete_personage. Every tool is scoped to the authenticated YaniFend account — you only see and edit your own site's data.

Prompts

Reusable starting points your MCP client can offer:

Prompt	What it does
new_feedback_form	Spin up a new personage + questionary for a goal, then return the embed snippet
embed_widget	Walk through embedding a widget on a site, incl. the allowed-domains check
clone_form	Copy an existing questionary onto another personage
review_feedback	Summarize the latest collected answers for a personage

About YaniFend

yanifend.com — a feedback widget that lets any website (HR / recruiter / SaaS / e-commerce, custom-built or WordPress) collect structured visitor feedback with personage-based segmentation. Drop in one script tag, or use the WordPress plugin. The MCP server is the LLM-native way to manage your YaniFend instance.

Privacy Policy

Full policy: https://yanifend.com/privacy

• Data collection. The extension collects only the YaniFend account credentials you enter in its settings and the tool inputs you provide in chat. It does not read files, browsing history, or anything else on your machine.
• Usage and storage. Credentials are stored locally by Claude Desktop (OS keychain) and used solely to obtain a short-lived access token from app.yanifend.com over HTTPS. Tool calls and results flow directly between your machine and the YaniFend API; this extension keeps no database and writes no logs of your data.
• Third-party sharing. Nothing is sent to any party other than YaniFend (app.yanifend.com). No analytics, no trackers.
• Data retention. The extension itself retains nothing beyond the in-memory session token (discarded on exit). Feedback data lives in your YaniFend account and follows the retention terms of the YaniFend privacy policy; deleting your account cascades all of it.
• Contact. support@yanifend.com

License

MIT — see LICENSE.