Freshsuccess MCP. Manage account health and customer usage via natural conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Freshsuccess MCP Server connects your Freshdesk Customer Success account to your AI agent. Use it to track account health scores, list customer usage metrics, and manage user data for proactive customer retention.
Your agent can list all active alerts, update user records, and log custom metrics, making customer success operations run directly from chat.
What your AI agents can do
Check api status
Verifies if the API connection to Freshsuccess is working.
Get account health
Retrieves the health score and metadata for a specific customer account.
Get user health
Retrieves the health score and metadata for a specific user.
Retrieves the current health score and metadata for specific customer accounts or individual users.
Retrieves a list of all customer accounts and allows you to update or create new account records.
Lists all active customer success alerts or retrieves pending tasks assigned to the team.
Creates or updates user profiles within the system.
Posts specific data points (like API call counts or feature usage) to an account or user to influence their health score.
Lists defined custom metrics or retrieves a list of all users associated with a given account.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Freshsuccess MCP Server: 11 Tools for Customer Success
Use these tools to manage account metadata, check user health, list active alerts, and record custom usage metrics via your agent.
019d75a0check api status
Verifies if the API connection to Freshsuccess is working.
019d75a0get account health
Retrieves the health score and metadata for a specific customer account.
019d75a0get user health
Retrieves the health score and metadata for a specific user.
019d75a0list cs accounts
Lists all available customer accounts in the system.
019d75a0list cs alerts
Lists all currently active customer success alerts, such as usage drops.
019d75a0list cs tasks
Retrieves a list of pending customer success tasks or to-dos.
019d75a0list cs users
Lists all users associated with a specific customer account.
019d75a0list custom metrics
Lists all custom metrics that have been defined in the system.
019d75a0post metric value
Records a specific custom metric value (e.g., 'api_calls') for an account or user.
019d75a0upsert cs account
Creates or updates the metadata for a customer account.
019d75a0upsert cs user
Creates or updates the metadata for a user within an account.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Freshsuccess, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Freshsuccess MCP Server connects your Freshdesk Customer Success account right to your AI agent. It lets your agent track account health scores, list usage metrics, and manage user data so you can work on customer retention without leaving your chat. You'll be able to list all active alerts, update user records, and log custom metrics, running all of that stuff straight from your chat window.
Checking the API Status lets you verify if the API connection to Freshsuccess is working.
Getting Account Health retrieves the health score and metadata for a specific customer account.
Getting User Health retrieves the health score and metadata for a specific user.
Listing Customer Accounts shows you every available customer account in the system.
Listing Customer Alerts lists all currently active customer success alerts, like when a user drops off in usage.
Listing Customer Tasks gets you a list of pending customer success tasks or to-dos.
Listing Customer Users shows all users tied to a specific customer account.
Listing Custom Metrics shows you every custom metric defined in the system.
Posting Metric Value records a specific custom metric value—say, 'api_calls'—for either an account or a user.
Updating Account Metadata creates or updates the metadata for a customer account.
Updating User Metadata creates or updates the metadata for a user within an account.
How Freshsuccess MCP Works
- 1 Subscribe to the Freshsuccess server on the Vinkius Marketplace.
- 2 Input your Freshsuccess Region Domain and API Key into your agent's settings.
- 3 Tell your agent to perform a specific action, like 'Check the health score for account X' or 'List all active alerts.' The agent runs the necessary tool call and returns the data.
The bottom line is, your agent handles all the API calls—you just talk to it.
Who Is Freshsuccess MCP For?
This is for Customer Success Managers (CSMs) who need to keep up with dozens of accounts daily. It's for CS Ops Engineers tired of switching between the CRM, the internal dashboard, and a spreadsheet. If you spend too much time manually checking health scores or logging usage data, this saves you hours.
Checks an account's health score or active alerts instantly without navigating the full dashboard. They can also check the last recorded usage metric for a key client.
Automates the logging of custom usage metrics or verifies user mappings for a client using simple agent commands. They maintain data consistency across systems.
Gets a real-time overview of customer adoption and health status right before a renewal conversation, without having to export reports.
What Changes When You Connect
- Track account health scores instantly. Instead of digging through dashboards, ask the agent to 'Show me the health score for account X' using
get_account_health. You get an immediate, color-coded status. - Prevent churn by seeing active issues. Use
list_cs_alertsto pull a list of critical alerts, like 'Drop in Login Frequency,' and prioritize your team's outreach efforts instantly. - Keep data consistent across systems. Use
upsert_cs_accountto update account metadata orupsert_cs_userto fix user records. This ensures your CRM and CS platform stay perfectly aligned. - Influence health scores with usage data. When a client uses a new feature, use
post_metric_valueto record that custom metric. This feeds directly into the health score calculation. - Streamline team accountability. Use
list_cs_tasksto pull pending tasks and to-dos for the team, keeping everyone aligned on who owns which retention effort. - Quickly audit client usage. You can list all users (
list_cs_users) and then check their individual health (get_user_health) to verify adoption rates before a big meeting.
Real-World Use Cases
Renewal Prep: Assessing Adoption
An Account Executive needs to know if a client is adopting the new feature before a Q3 renewal meeting. They ask their agent to run list_cs_users and then get_user_health for the account. The agent reports the usage and health score immediately, letting the AE walk into the meeting with hard data, not gut feelings.
Handling Critical Outages
A CSM notices a spike in support tickets and needs to know if it's tied to a specific user group. They ask the agent to run list_cs_alerts to find the alert. Then, they use get_account_health to see if the entire account status is affected, isolating the problem quickly.
Data Cleanup and Synchronization
A CS Ops Engineer identifies a user account that needs a name change and a new email address. Instead of logging into the UI, they tell the agent to run upsert_cs_user. The agent updates the record directly and confirms the change, keeping the data source clean.
Measuring Feature Adoption
The team just launched a new API endpoint. A CSM wants to track how many clients use it. They ask the agent to run list_custom_metrics to see the defined metric, and then post_metric_value to record the count for the relevant accounts.
The Tradeoffs
Treating it like a simple dashboard query
Asking the agent, 'What's wrong with Acme Corp?' and expecting a single, comprehensive summary. The agent can't just guess the root cause or pull metrics that haven't been recorded.
→
You need to ask for specific data points. Start by running list_cs_alerts to see what the system flagged. Then, if you need deeper metrics, use get_account_health combined with post_metric_value to record the missing data point.
Manual data entry for updates
A user profile needs an email update. The old way is to log into the Freshsuccess portal and manually change the record, wasting time and risking keystroke errors.
→
Just tell your agent to run upsert_cs_user with the new details. It handles the update and confirms the record is live, saving you the clicks.
Assuming data consistency
Thinking that because the account exists, all associated users and metrics are correct. The data can drift, leading to bad reports and poor customer decisions.
→
Always check first. Run list_cs_accounts to confirm the primary account ID, and then use list_cs_users and get_account_health to verify all dependent records before making changes.
When It Fits, When It Doesn't
Use this server if your primary job involves checking account health, monitoring client usage, or updating customer records based on conversation. You need to know why a customer is struggling, not just that they are struggling. The server is perfect for CSMs and Ops Engineers. Don't use it if you just need to run a single, simple report (e.g., 'list all accounts'). Use a dedicated reporting tool for that. If you need to check the API connection status, use the check_api_status tool first. If you only need to read data and never write it, the read-only tools are enough; if you need to write or update, you need the full suite.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Freshsuccess. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 11 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually pulling account health data is a click-heavy nightmare.
Today, you have to jump between the account dashboard, the usage logs, and the alerts tab. You click to find the health score, then copy the account ID, paste it into a separate tab to see user metrics, and then copy that ID again to check pending tasks. It's a mess of tabs and clipboard juggling.
With the Freshsuccess MCP Server, you just tell your agent, 'Check the health and alerts for account X.' The agent runs the necessary tools—`get_account_health`, `list_cs_alerts`, and `list_cs_users`—and gives you the full picture in one response. Period.
Freshsuccess MCP Server: Log usage metrics in plain conversation.
Before, if you wanted to manually log a custom metric—say, 'API calls' for a client—you had to navigate to a specific custom metrics section, find the account, and input the value. It was slow and error-prone.
Now, you just tell your agent: 'Post a custom metric of 150 for API calls for user Y.' The agent uses `post_metric_value`, records the data point, and confirms it's factored into the health score. It's that simple.
Common Questions About Freshsuccess MCP
How do I get an API Key for Freshsuccess? +
Log in to your Freshsuccess account, navigate to Settings > Third-party integrations > API, and generate or copy your active token.
What is my 'Region Domain'? +
Your domain depends on where your account is hosted (e.g. 'api-us.freshsuccess.com' for US Data Center, 'api-eu.freshsuccess.com' for Europe).
Can I update an account's metadata using the agent? +
Yes! Use the 'upsert_cs_account' tool. Provide the unique Account ID and the new name to instantly update the record in Freshsuccess.
Is it possible to log custom product metrics? +
Absolutely. You can use the 'post_metric_value' tool to send raw numeric data for specific accounts or users to influence their health scores.
How do I use the `list_cs_accounts` tool to check multiple accounts? +
The list_cs_accounts tool returns a list of all customer accounts. You can ask your agent to filter this list by assigned CSM or by health score range for targeted analysis.
What happens if I try to `post_metric_value` with invalid data? +
The server handles invalid inputs by returning a specific error code and detailing which field failed validation. You can then adjust your prompt to ensure data types match the expected format.
Can the agent use `list_cs_alerts` to check for a specific alert type? +
Yes, the list_cs_alerts tool accepts filtering parameters. Simply specify the alert type (e.g., 'Low Usage') or the associated account ID in your prompt.
Does the server support batch updates using `upsert_cs_user`? +
The upsert_cs_user tool processes one user record at a time. To update multiple users, run the command sequentially for each user ID or structure your request to handle an array of records.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Pipedrive Products
Manage your product catalog, attach products to deals, and track recurring revenue subscriptions in Pipedrive.
Feathery
Automate forms and user workflows via Feathery — manage users, retrieve form data, and monitor connector logs directly through your AI agent.
Fellow
Manage meeting notes and feedback via Fellow — list agenda items and decisions, track action items, handle recordings, and complete tasks directly from any AI agent.
You might also like
ECB Monetary — Money Supply, Yield Curves & Banknotes
Eurozone monetary data: M1, M2, and M3 money supply aggregates, government bond yield curves from 3 months to 30 years, full yield curve snapshots, and euro banknotes in circulation statistics from the European Central Bank.
StayFi
Connect your AI agents to StayFi to capture guest emails, manage WiFi properties, monitor networks, and track marketing analytics.
TheCocktailDB
Search cocktail recipes by name, ingredient, or category — with full mixing instructions, measurements, glass type, and cocktail images.