How to Use the Freshsales (Sales CRM & Lead Scoring API) MCP in OpenAI Agents SDK

Q: How does the OpenAI Agents SDK automate lead scoring with Freshsales (Sales CRM & Lead Scoring API)?

Your agent can use getlead to pull the current score from Freshsales. Based on that score and your own business logic, it can then trigger other tools like createtask for an SDR to follow up or updatelead to change its status.

Build production-ready sales agents that manage your Freshsales pipeline using the OpenAI Agents SDK.

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 OpenAI Agents SDK

Create your Vinkius account to connect Freshsales (Sales CRM & Lead Scoring API) to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safely manage your sales leads

Give your agent the tools to manage your entire lead funnel. It can add new prospects with `create_lead`, update their status with `update_lead`, and check details anytime using `get_lead`. Because the OpenAI Agents SDK includes guardrails, you can define rules that prevent the agent from making mistakes, like converting a low-quality lead. Your agent can use `convert_lead` to turn a hot prospect into a contact, but only after your specific business logic gives the green light.

Automate your deal pipeline with this MCP Server

Connect your agent directly to your deal flow. It can open a new opportunity with `create_deal` and then track its journey through your sales process by checking `list_deal_stages`. When a follow-up is needed, your agent can schedule meetings with `create_appointment` or assign research work with `create_task`. The OpenAI dashboard gives you a full trace of every action, so you know exactly why an agent decided to move a deal forward or create a specific task.

Keep your CRM data clean

A messy CRM kills sales velocity. Before adding anything new, your agent can run `search_global` to check if a person or company already exists. This simple check prevents duplicate records from cluttering your database. Once it's confirmed the record is new, the agent can safely use `create_contact` and `create_account`. This MCP Server integration ensures that every action is deliberate, helping you maintain a clean and reliable source of truth for your sales team.

Setup guide

Set up Freshsales (Sales CRM & Lead Scoring API) MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Freshsales (Sales CRM & Lead Scoring API) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Freshsales (Sales CRM & Lead Scoring API) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Freshsales (Sales CRM & Lead Scoring API) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Freshsales (Sales CRM & Lead Scoring API) Agent",
            instructions="You have access to Freshsales (Sales CRM & Lead Scoring API) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Your agent can use `get_lead` to pull the current score from Freshsales. Based on that score and your own business logic, it can then trigger other tools like `create_task` for an SDR to follow up or `update_lead` to change its status.

Yes. While the MCP Server exposes all 21 tools, you configure the agent's permissions within your own code. You can create specialized agents, for instance, one that can only read data with `list_leads` and another that is authorized to write data with `create_deal`.

You get production-grade safety and control. The SDK's guardrails and tracing let you build reliable sales agents that you can actually deploy, not just prototype. It's about automating CRM tasks with confidence.

You just need your Vinkius endpoint URL. In your Python code, you'll instantiate the `MCPServerStreamableHttp` class with that URL and pass it to your agent's constructor. The agent discovers all the available tools automatically.

Vinkius processes data, but doesn't store it. When your agent uses a tool like `get_contact` or `update_deal`, the necessary contact and deal information passes through an ephemeral, sandboxed environment. Nothing is logged or retained on the Vinkius platform.

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