How to Use the lemon.markets MCP in OpenAI Agents SDK
Execute European stock trades safely through the OpenAI Agents SDK using verified trade guardrails and automatic tool routing.
Works with every AI agent you already use
…and any MCP-compatible client
Connect lemon.markets MCP to OpenAI Agents SDK
Create your Vinkius account to connect lemon.markets 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.
Safe Order Routing via OpenAI Agents SDK
When running the OpenAI Agents SDK, calling `place_new_order` starts the trade lifecycle inside your agent pipeline by staging a buy or sell request on lemon.markets. Your OpenAI agent verifies the order parameters against your custom safety guardrails before triggering `activate_pending_order` to execute the transaction. If a trade fails validation, the OpenAI Agents SDK automatically invokes `cancel_open_order` to prevent unwanted market exposure. Using an MCP Server ensures this lemon.markets execution logic is decoupled from your main OpenAI application.
Real-Time Portfolio Tracking and Balance Sweeps
The `get_brokerage_account` tool pulls live cash balances and account details directly into your OpenAI Agents SDK runtime from lemon.markets. Your OpenAI agent uses this real-time balance data to calculate maximum position sizing before searching for new assets. Once the balance is verified, the OpenAI Agents SDK calls `list_active_positions` to check current lemon.markets holdings and prevent duplicate trades. This entire portfolio verification flow runs inside a single, traceable execution stream on your OpenAI dashboard.
Automated Market Scanning and Execution
Using `search_market_instruments` lets your OpenAI agent scan European markets for specific ISINs directly from your Python terminal. The OpenAI Agents SDK handles the MCP tool discovery automatically, mapping the lemon.markets search results directly to your trading logic. After finding the right instrument, the OpenAI Agents SDK pulls the current bid/ask spread using `get_latest_quote` to verify pricing. This ensures your OpenAI trading agents only execute lemon.markets orders when spreads match your predefined execution criteria.
Set up lemon.markets MCP in OpenAI Agents SDK
Prerequisites
- Python 3.10+ installed
-
openai-agentspackage (pip install openai-agents) - Active Vinkius subscription with a valid endpoint token
- 1
Install the SDK
Run
pip install openai-agentsto install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed. - 2
Connect via SSE transport
Use
MCPServerSsewith your Vinkius endpoint URL. Replace[YOUR_TOKEN_HERE]with your token from cloud.vinkius.com. The SDK auto-discovers all lemon.markets tools at runtime. - 3
Create your Agent
Pass the MCP to
Agent(mcp_servers=[server]). The agent receives lemon.markets tools as native definitions — JSON schemas resolve automatically. - 4
Run the agent
Call
Runner.run(agent, prompt)to execute. The agent invokes the appropriate lemon.markets tools and returns structured results. Copy the full example on the right to get started.
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="lemon.markets Agent",
instructions="You have access to lemon.markets tools.",
mcp_servers=[server],
)
result = await Runner.run(agent, "List recent transactions")
print(result.final_output)
asyncio.run(main())Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by lemon.markets. 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.
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 lemon.markets MCP in OpenAI Agents SDK
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the lemon.markets MCP today
We host it, we monitor it, we maintain it. You just paste one token.
