How to Use the HighLevel MCP in OpenAI Agents SDK

Q: Can OpenAI Agents SDK read HighLevel pipelines?

Yes. The server exposes listpipelines and searchopportunities. Your agents can read funnel stages directly.

Q: How do I stop the agent from booking overlapping meetings?

You enforce a strict sequence. The agent must call getcalendarfreeslots before it is allowed to execute createappointment.

Connect HighLevel to your OpenAI Agents SDK to let production agents read sales pipelines, book meetings, and manage CRM contacts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HighLevel MCP to OpenAI Agents SDK

Create your Vinkius account to connect HighLevel 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 HighLevel with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

OpenAI Agents SDK CRM routing

Your agent runs `search_contacts` first to check if an email already exists in the system. You don't want agents creating duplicate records. If the search returns empty, the agent fires `create_contact` with the required JSON body. You get clean data without manual intervention, and the OpenAI dashboard traces every single API call for debugging via this MCP connection.

Pipeline visibility via MCP Server

Agents execute `list_pipelines` to grab the location's active sales funnels before drafting follow-ups. Specialized agents need context before they talk to a lead. From there, they run `search_opportunities` to find exactly where a prospect sits in the flow. This setup lets your agent read the room before it decides what to do next.

Calendar booking guardrails

Your agent checks `list_calendars` to find the right team member before pulling open times with `get_calendar_free_slots`. Booking meetings automatically requires strict guardrails. It only triggers `create_appointment` when it confirms a valid opening. You avoid double-booking because the agent verifies state before it writes to the calendar.

Setup guide

Set up HighLevel 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 HighLevel tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives HighLevel tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate HighLevel 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="HighLevel Agent",
            instructions="You have access to HighLevel 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 HighLevel. 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 HighLevel 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 HighLevel MCP in OpenAI Agents SDK

Use MCPServerStreamableHttp and pass the endpoint URL. Add it to the mcp_servers list in your Agent constructor. Set cacheToolsList=True to speed up initialization.

Yes. The server exposes list_pipelines and search_opportunities. Your agents can read funnel stages directly.

You enforce a strict sequence. The agent must call get_calendar_free_slots before it is allowed to execute create_appointment.

Yes. You define the rules in your agent configuration. If an MCP tool call to create_contact_task violates a guardrail, the execution halts before hitting the API.

Vinkius routes the payloads through an ephemeral V8 Isolate Sandbox. When your agent pulls emails via get_contact_details, the memory wipes the second the HTTP request finishes. We store zero CRM records.

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