How to Use the Freshsales (Sales CRM & Lead Scoring API) MCP in Mastra AI

Q: How do I map lead sources in Mastra AI when connecting to the Freshsales (Sales CRM & Lead Scoring API)?

You run the listleadsources tool within an initialization step to fetch your active CRM categories. Mastra AI then uses these exact values to validate incoming webhooks before executing createlead.

Q: Can I search for existing accounts before creating duplicates?

The searchglobal tool lets your workflow scan the entire database for matching company names. If a match is found, the agent skips createaccount and instead associates the new contact with the existing record.

Build automated sales workflows that handle failures gracefully with Mastra AI and the Freshsales (Sales CRM & Lead Scoring API) MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Freshsales (Sales CRM & Lead Scoring API) MCP to Mastra AI

Create your Vinkius account to connect Freshsales (Sales CRM & Lead Scoring API) to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Freshsales (Sales CRM & Lead Scoring API) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated lead triage using Mastra AI

The `get_lead` tool retrieves detailed prospect profiles to evaluate their buying intent automatically. Mastra AI uses this data to run conditional checks, routing high-value prospects to active sales reps without human intervention. If the lead score meets your threshold, the workflow triggers `convert_lead` to instantly turn that prospect into an active contact. This step eliminates the lag time between a user showing interest and your sales team making contact.

Resilient deal pipeline updates

The `update_contact` tool modifies existing records when a prospect's behavior changes. Mastra AI manages this process through its built-in retry engine, ensuring that transient network errors don't result in out-of-date CRM records. When a deal progresses, the workflow calls `create_deal` to log the opportunity in the correct pipeline stage. If the API returns a rate-limit error, the framework backs off exponentially before trying the write operation again.

Sync schedules using Mastra AI MCP Server

The `create_appointment` tool schedules sales calls directly from your automated email threads. Mastra AI coordinates these bookings by checking available slots and writing the event details back to the CRM. To keep the sales team aligned, the workflow also runs `create_note` to attach the context of the meeting directly to the contact record. This ensures that the assigned rep has all the historical data handy before they dial the number.

Setup guide

Set up Freshsales (Sales CRM & Lead Scoring API) MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Freshsales (Sales CRM & Lead Scoring API) tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "freshsales-sales-crm-lead-scoring-api-mcp-client",
  servers: {
    "freshsales-sales-crm-lead-scoring-api-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Freshsales (Sales CRM & Lead Scoring API) Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Freshsales (Sales CRM & Lead Scoring API) tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Freshsales (Sales CRM & Lead Scoring API) transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Freshsales. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Freshsales (Sales CRM & Lead Scoring API) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Freshsales (Sales CRM & Lead Scoring API) MCP in Mastra AI

You register the server tools within your Mastra workflow definition. If an action like `create_deal` fails due to a rate limit, the built-in workflow engine retries the call using exponential backoff automatically.

Yes, you can use the human-in-the-loop feature. This pauses the execution before running `convert_lead` or `update_contact`, requiring a manager's sign-off in your dashboard before writing to the CRM.

You run the `list_lead_sources` tool within an initialization step to fetch your active CRM categories. Mastra AI then uses these exact values to validate incoming webhooks before executing `create_lead`.

The `search_global` tool lets your workflow scan the entire database for matching company names. If a match is found, the agent skips `create_account` and instead associates the new contact with the existing record.

No, because Vinkius executes the code within zero-trust ephemeral environments. Your API tokens, account records, and custom notes are only loaded in memory during the execution of a specific tool call and are wiped immediately afterward.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript