# ClientSuccess MCP for AI Agents AI Agent Connect

> ClientSuccess MCP for AI Agents. Reduce churn and grow accounts with health scoring, engagement tracking, and success playbooks built for customer success teams. It connects your ClientSuccess platform to your AI client so you can manage relationships, track account health, and monitor contracts through natural conversation.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_n6kZ0owwCN5FBwIUWfWypOz9fJyh0bLLwlX5B0MN/ai-agent-connect
- **Tags:** customer-success, churn-reduction, health-scoring, account-management, saas-retention, engagement-tracking

## Description

This Connector connects your ClientSuccess platform to your AI agent to simplify how you manage client relationships and monitor service contracts. You can query customer segments, pull detailed metadata, and check health scores to see which accounts are at risk of churning. It handles the heavy lifting of data retrieval so you can focus on actual strategy. Whether you're looking for a list of active clients or digging into a specific account's renewal status, this tool makes that data accessible right where you're already working. It's part of the Vinkius catalog, which makes it easy to plug into your existing AI workflow. Instead of jumping between tabs to find a contract date, you just ask your agent to find it for you. It puts your customer success data into a conversational format that actually makes sense for your daily tasks.

## Tools

### create_client
Create a new client record in your system. This lets you build out your database without leaving your AI chat.

### list_clients
Get a full list of your managed clients. Use this to see every account currently in your portfolio.

### list_contacts
Pull a list of contacts for a specific client. This helps you find the right people to reach out to quickly.

### list_contracts
View all active and historic service contracts. Use this to keep track of renewals and agreement dates.

### list_segments
See how your customers are grouped into different segments. This helps you understand your client distribution.

### get_client_details
Pull deep metadata and health scores for a specific client. This is how you identify at-risk accounts instantly.

## Prompt Examples

**Prompt:** 
```
Who are my top 5 at-risk clients based on health scores?
```

**Response:** 
```
I've analyzed your ClientSuccess data. Here are the 5 accounts with the lowest health scores:

| Client Name | Health Score | Status | Primary Contact |
| :--- | :--- | :--- | :--- |
| **Acme Corp** | 42/100 | Critical | Sarah Smith |
| **Global Logistics** | 48/100 | At Risk | John Doe |
| **Tech Giant** | 50/100 | Warning | Elena Rodriguez |
| **Retail Hub** | 52/100 | Warning | Mike Chen |
| **DataStream** | 55/100 | Warning | Lisa Wong |

Would you like me to pull the contract details for any of these?
```

**Prompt:** 
```
List the contracts for Acme Corp.
```

**Response:** 
```
Fetching contract data for **Acme Corp**... 

I found 2 active contracts:
*   **Master Service Agreement** (ID: CON-992) - Expires: Dec 31, 2024
*   **Premium Support Addendum** (ID: CON-104) - Expires: June 30, 2025

Do you need to see the contact list for this account as well?
```

**Prompt:** 
```
What segments do we have for mid-market customers?
```

**Response:** 
```
I've retrieved your customer segments. You currently have the following segments configured:

*   **Enterprise**
*   **Mid-Market**
*   **SMB**
*   **Strategic Accounts**
*   **Beta Testers**

Which segment would you like to explore further?
```

## Capabilities

### Pull a full list of managed clients
Get a complete directory of every account currently in your portfolio.

### Retrieve specific client metadata
Get deep health scores and success status for individual accounts.

### Query customer segments
See how your customers are grouped into different categories and distributions.

### Check active and historic contracts
View all service agreements to keep track of renewals and expiration dates.

### Create new client records
Add new client information to your system without leaving your AI chat.

### Fetch contact lists
Pull a list of key stakeholders for a specific client to find the right person to reach out to.

## Use Cases

### Identifying churn risk
A CSM wants to know who's at risk. They ask the agent to find clients with low health scores and then ask for the contact details.

### Segment distribution analysis
A Success Ops lead needs to check segments. They ask the agent to list all segments to see how the mid-market is distributed.

### Renewal tracking
A manager wants to see upcoming renewals. They ask the agent to find all active contracts and sort them by date.

### Quick record creation
An account manager needs to add a new client. They tell the agent the client name and details, and the agent creates the record.

## Benefits

- Identify at-risk accounts faster by pulling health scores directly into your chat.
- Save time on manual data entry by using create_client to add new records.
- Get a better view of your portfolio by using list_clients to see all active accounts.
- Simplify renewal tracking by checking list_contracts for upcoming dates.
- Understand your customer base better by querying list_segments for distribution data.
- Find key stakeholders quickly by using list_contacts to pull specific team members.

## How It Works

The bottom line is you get instant access to your customer success data within any AI-compatible workspace.

1. Subscribe to the ClientSuccess MCP.
2. Enter your ClientSuccess API Key from your account settings.
3. Ask your AI agent to pull client data or check health scores.

## Frequently Asked Questions

**Can I use ClientSuccess MCP to see my churn risk?**
Yes, it pulls health scores and metadata so you can identify at-risk accounts instantly without leaving your AI workspace.

**How does ClientSuccess MCP help with renewals?**
It lists all your active and historic contracts so you can track dates and upcoming expirations without manual searching.

**Can I add new clients using ClientSuccess MCP?**
You can create new client records directly through your AI agent to keep your data updated in real-time.

**Does ClientSuccess MCP show customer segments?**
Yes, it lets you query your customer segments to see how your accounts are categorized and distributed.

**Can I find contact info for my clients?**
You can pull lists of contacts for specific clients to find the right person to reach out to quickly.

**Is ClientSuccess MCP good for CSMs?**
It's designed for CSMs to get a bird's-eye view of account health and manage relationships much faster.

**Can I check a client's health score via AI?**
Yes! Use the `get_client_details` tool and provide the Client ID. Your agent will retrieve the current health score, success status, and metadata.

**How do I list all the contracts associated with my clients?**
Run the `list_contracts` query. The agent will retrieve a history of active and previous service contracts recorded in your ClientSuccess account.

**Is it possible to see the available customer segments via AI?**
Absolutely. Use the `list_segments` query. The agent will retrieve the complete list of customer segments used to categorize your client base.