An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect Freshsales Sales CRM Lead Scoring API to your AI

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Run your entire sales pipeline through your AI agent.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 21 capabilities

We ship only the actions that matter.

Capability set01 / 06

01-04

4 capabilities in this set.

Part of 21 available through Freshsales.

  1. 01

    Convert lead

    Converts a qualified lead into a contact. You must provide the last name and company name to complete this action.

  2. 02

    Create note

    Attaches a new note to a specific CRM record.

  3. 03

    Get lead

    Fetches the details of a specific lead.

  4. 04

    List lead sources

    Provides a list of all lead sources configured in your CRM.

Capability set02 / 06

05-08

4 capabilities in this set.

Part of 21 available through Freshsales.

  1. 05

    List leads

    Lists all leads belonging to a specific view ID.

  2. 06

    Create lead

    Creates a new lead, requiring at least an email or a first name.

  3. 07

    Create account

    Adds a new sales account to your CRM.

  4. 08

    Create appointment

    Schedules a new appointment within your sales calendar.

Capability set03 / 06

09-12

4 capabilities in this set.

Part of 21 available through Freshsales.

  1. 09

    Create contact

    Adds a new contact record to your database.

  2. 10

    Create deal

    Generates a new deal to track in your sales pipeline.

  3. 11

    Create task

    Sets a new task for follow-up or workflow management.

  4. 12

    Get account

    Fetches the details of a specific sales account.

Capability set04 / 06

13-15

3 capabilities in this set.

Part of 21 available through Freshsales.

  1. 13

    Get contact

    Retrieves the full details for a specific contact.

  2. 14

    Get deal

    Retrieves information for a specific deal.

  3. 15

    List deal stages

    Fetches the various stages available in your deal pipeline.

Capability set05 / 06

16-18

3 capabilities in this set.

Part of 21 available through Freshsales.

  1. 16

    List industry types

    Returns a list of available industry types in your CRM.

  2. 17

    List owners

    Retrieves a list of all users or owners in the system.

  3. 18

    Search global

    Searches across all entities to find specific records.

Capability set06 / 06

19-21

3 capabilities in this set.

Part of 21 available through Freshsales.

  1. 19

    Search lookup

    Performs a targeted search for specific fields within your records.

  2. 20

    Update contact

    Modifies information on an existing contact record.

  3. 21

    Update lead

    Updates the information on an existing lead.

Real work

What teams actually run

01

Post-Meeting Updates

After a call, tell your agent to log a note and create a follow-up task.

02

Lead Qualification

Convert a lead to a contact once you have verified their company details.

03

Pipeline Auditing

Ask your agent to list all deals in a specific stage to check progress.

04

Quick Data Lookups

Find a client's account details instantly using a global search.

Automate a task

Put Freshsales to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Freshsales works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put Freshsales to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1026ms average. Fast in production.

Freshsales is checked daily against the live service.

Daily averagePeak 1238ms
Oct 3Today
Fastest day
767ms
Slowest day
1238ms
14-day trend
Stable-1%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 21 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Freshsales, so you can see the experience inside your AI.

It does not authenticate your account with Freshsales. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Freshsales Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_lNIxhRpxCF9DBuKiEkjQF3avIjlA8qRyKDpODQjh/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Freshsales capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "freshsales-sales-crm-lead-scoring-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lNIxhRpxCF9DBuKiEkjQF3avIjlA8qRyKDpODQjh/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Freshsales in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Freshsales owners hand off.

This MCP is built for sales professionals who want to spend less time typing into a CRM and more time talking to customers.

  • 01

    Sales Representatives

    They use the AI to update lead statuses and log meeting notes instantly.

  • 02

    Sales Managers

    They ask the AI for quick reports on deal stages and lead sources.

  • 03

    Account Executives

    They manage contact and account details while preparing for client meetings.

FAQ

Questions Freshsales owners ask.

  • 01

    How do I connect my Freshsales account?

    You subscribe to the MCP on Vinkius and enter your Freshsales Domain and API Key. Once connected, it is ready to use in your AI client.

  • 02

    Which AI clients can I use with this MCP?

    You can use this MCP with any compatible client, including Claude, Cursor, and Windsurf.

  • 03

    Can I create new leads through the AI?

    Yes, you can create new leads by providing at least a first name or an email address to your agent.

  • 04

    Is my CRM data secure?

    Vinkius manages your credentials and hosts the MCP to ensure a secure and stable connection to your Freshsales instance.

  • 05

    Can I search for specific contacts?

    Yes, you can use the search capabilities to find contacts, leads, or accounts using email, names, or other identifiers.

  • 06

    How can I find a lead if I only have their email address?

    You can use the search_lookup capability. It allows you to search for records like leads or contacts specifically by fields such as email, ensuring you find the exact record you need.

  • 07

    Can I convert a lead to a contact directly through the AI?

    Yes! Use the convert_lead capability. You will need to provide the Lead ID, and ensure you have the mandatory last name and company name to complete the conversion.

  • 08

    How do I see what stages are available for my sales deals?

    Simply use the list_deal_stages capability. It will retrieve all the configured pipeline stages from your Freshsales account so you can categorize your deals correctly.

Explore

More in Sales Automation

Suggestions

Connect Freshsales to Claude, Cursor, ChatGPT & more