How to Use the EasyPractice MCP in OpenAI Agents SDK

Give your OpenAI Agents SDK agents direct, secure access to your clinic's schedules, billing, and patient records.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect EasyPractice MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit Clinic Volume Safely

The `quick_clinic_volume_audit` tool pulls high-level clinic metrics to track appointment patterns using this MCP tool. You feed this tool directly to your OpenAI Agents SDK agent, and the built-in guardrails validate the action before execution. This setup stops the agent from making rogue API requests when analyzing clinic performance. You see every single data fetch in real-time on your OpenAI tracing dashboard.

Sync Invoices with this MCP Server

The `list_clinic_invoices` tool pulls billing records straight into your OpenAI Agents SDK workflow. You set up a specialized billing agent that auto-discovers this tool, allowing it to flag unpaid balances without manual export steps. Isolating this tool inside a dedicated billing agent ensures financial data stays secure. The agent handles the handoff back to the main scheduler when it finishes checking outstanding bills.

Track Client Profiles and History

The `get_client_details` tool retrieves a patient's complete history for your OpenAI Agents SDK system. Your agent calls this tool to prepare for upcoming visits, matching historical notes with current scheduling requests. You configure the streamable HTTP server parameter to keep these lookups fast and secure. The agent handles the data in memory, keeping patient records clean without local storage.

Setup guide

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

Create your Agent

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

Run the agent

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

You pass the streamable HTTP params directly into the agent constructor using the `mcp_servers` parameter. The OpenAI Agents SDK automatically registers all ten clinic management tools without manual mapping. This makes the MCP setup incredibly fast.

Yes, you control access by defining specific system prompts and agent roles in your Python code. You assign the invoicing tools to a billing agent and keep scheduling tools restricted to your front-desk agent.

The SDK handles rate limits through standard Python try-except blocks and agent retry logic. You monitor these calls directly in the OpenAI tracing dashboard to catch performance bottlenecks early.

No, Vinkius hosts the server for you. You just copy the hosted HTTP endpoint URL and paste it into your agent's configuration stream.

Your clinic appointments, billing invoices, and client profiles never touch public servers. Vinkius runs the connector inside an isolated V8 sandbox, routing your data directly through encrypted HTTPS streams to your OpenAI environment.

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