# Freshsales MCP for AI Agents AI Agent Connect

> Freshsales MCP lets you manage your CRM pipelines, track leads, and oversee sales deals using your AI agent. Instead of clicking through tabs, you can ask your agent to pull contact details, update deal stages, or create new leads instantly. It turns your CRM into a conversational workspace where you can manage your sales cycle without leaving your primary chat or code editor.

## Overview
- **Category:** business-operations
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_yJCENcQWUO8ecWxvPvGrrwGasAmphz3YwuDrebpU/ai-agent-connect
- **Tags:** lead-management, pipeline-management, deal-tracking, sales-automation, contact-management

## Description

Imagine you're in the middle of a discovery call and need to know a prospect's history, or you're trying to remember which deal is stuck in the negotiation phase. Usually, that means tab-switching and digging through a cluttered dashboard. This Connector changes that by putting your Freshsales data directly into your AI agent's hands. You can ask your agent to pull up a lead's profile, list all active deals, or check for upcoming appointments while you stay focused on the task at hand. It's about making your CRM data actionable in real-time. By connecting your account through the Vinkius Marketplace, you give your agent the context it needs to help you manage your pipeline more effectively. You're no longer just looking at data; you're interacting with it. Whether you're an SDR trying to keep your pipeline full or a manager checking team workloads, this connection ensures your CRM is a tool you actually use, not just another tab you have to manage.

## Tools

### get_account_details
Get metadata for a specific account. Use this to see company-level details during a call.

### get_contact_metadata
Get specific contact details. This lets your agent pull up phone numbers or emails instantly.

### get_deal_details
Get metadata for a specific deal. Use this to see the current status and value of an opportunity.

### list_appointments
List all scheduled appointments. This keeps your calendar visible to your agent for better scheduling.

### get_lead_details
Get metadata for a specific lead. This provides the deep context needed to personalize your outreach.

### list_sales_accounts
List all CRM accounts. Use this to see your full B2B relationship landscape at once.

### create_crm_lead
Create a new lead in your CRM. This helps you add prospects quickly without manual form filling.

### list_crm_contacts
List all CRM contacts. Use this to search for specific people across your entire database.

### list_crm_deals
List all sales deals. This gives you a bird's eye view of your entire revenue pipeline.

### list_crm_leads
List CRM leads

### list_crm_tasks
List all pending tasks. Use this to ensure no follow-ups fall through the cracks.

### list_crm_users
List all CRM users. This helps managers see territory assignments and team activity.

## Prompt Examples

**Prompt:** 
```
Who is our main contact at Acme Corp?
```

**Response:** 
```
Searching your Freshsales accounts... I found Jane Smith as the primary contact for Acme Corp.

**Contact Details**
- **Name:** Jane Smith
- **Email:** jane@acme.com
- **Role:** VP of Sales

She is currently associated with 2 active deals in your pipeline.
```

**Prompt:** 
```
What deals are we currently tracking?
```

**Response:** 
```
Here are your active deals from Freshsales:

| Deal Name | Value | Stage |
| :--- | :--- | :--- |
| Acme Expansion | $50,000 | Negotiation |
| Globex Renewal | $15,000 | Closed Won |
| TechCorp Pilot | $25,000 | Discovery |
```

**Prompt:** 
```
Create a new lead for Mark Evans at mark@example.com.
```

**Response:** 
```
Done! I've added Mark Evans to your Freshsales CRM. The new lead ID is 44921.
```

## Capabilities

### Create new leads
Add new prospects to your CRM immediately through a chat interface.

### Fetch contact profiles
Pull detailed metadata for specific contacts to get context before a call.

### Track sales deals
View all active opportunities and their current stages in your pipeline.

### List company accounts
Get a bird's eye view of your B2B relationships and account data.

### Monitor tasks and appointments
Check your scheduled meetings and pending follow-ups in one place.

### View sales team workloads
See a list of all CRM users to understand territory and rep assignments.

## Use Cases

### Quick Prospect Check
An SDR asks, 'What's the history with Jane Smith?' and gets a summary of her contact details and active deals immediately.

### Pipeline Audit
A manager asks for a list of all deals over $10k and the agent pulls the metadata for every relevant opportunity.

### Lead Creation
An AE finds a new lead in a LinkedIn message and tells the agent to create a new lead, saving them from opening a new tab.

### Task Management
A rep asks what they need to do today, and the agent pulls all pending tasks and appointments from the CRM.

## Benefits

- Stop hunting for info with get_contact_metadata, which brings prospect details directly to your chat.
- Keep your pipeline moving by using list_crm_deals to see every active opportunity in one list.
- Never miss a follow-up again by having your agent monitor list_crm_tasks and list_appointments.
- Speed up lead gen by using create_crm_lead to add new prospects the moment you find them.
- Get a clear view of your team's capacity by calling list_crm_users to see representative workloads.
- Maintain B2B context by using list_sales_accounts to see the full scope of your company relationships.

## How It Works

The bottom line is you get a conversational interface for your entire sales pipeline without leaving your workspace.

1. Subscribe to the Freshsales MCP via the Vinkius Marketplace.
2. Enter your Freshsales Domain prefix and API Token from your profile settings.
3. Ask your AI client to list deals, create leads, or fetch contact details.

## Frequently Asked Questions

**Can I use the Freshsales MCP to see my current sales deals?**
Yes, you can ask your agent to list all active deals or get specific metadata for any opportunity in your pipeline. It gives you a quick way to see what's moving without opening the dashboard.

**How does the Freshsales MCP help with lead management?**
It lets you create new leads and fetch contact details through natural conversation. This means you don't have to manually fill out CRM forms every time you find a new prospect.

**Can my AI agent see my scheduled appointments?**
Yes, the Connector allows your agent to pull your list of upcoming appointments and pending tasks. This helps you stay on top of your schedule and ensure no follow-ups fall through the cracks.

**Is the Freshsales MCP good for SDRs?**
It's built for high-velocity roles like SDRs who need to quickly verify contact details and create leads without leaving their primary workspace. It removes the friction of manual data entry.

**Can I see my sales team's workload with this?**
Yes, you can use it to list all CRM users to get a clear picture of territory assignments and representative workloads across your entire organization.

**How do I connect Freshsales to my AI client?**
You just need your Freshsales Domain prefix and API Token from your profile settings to get started through the Vinkius Marketplace. Once connected, your agent can access your CRM data immediately.

**How do I get an API Key for Freshsales?**
Log in to your Freshsales account, click on your Profile picture in the top-right corner, go to 'Profile Settings', and navigate to the 'API Settings' tab to find your Token.

**What is my 'Domain prefix'?**
Your domain prefix is the first part of your Freshsales or Freshworks CRM URL (e.g. if your URL is 'acme.myfreshworks.com/crm/sales' or 'acme.freshsales.io', the prefix is 'acme').

**Can I create a new lead through the agent?**
Yes! Use the 'create_crm_lead' tool and provide the first name, last name, and optionally an email address to instantly add them to your CRM.

**Are custom fields supported?**
When you retrieve a record (like a deal or contact) using tools like 'get_deal_details', the agent fetches the complete metadata payload, which includes all configured custom fields.