How to Use the Mashvisor MCP in OpenAI Agents SDK
Feed real-time property yields and Airbnb performance directly to your OpenAI Agents SDK to automate rental investment decisions.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Mashvisor MCP to OpenAI Agents SDK
Create your Vinkius account to connect Mashvisor 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.
Filter properties with OpenAI Agents SDK guardrails
This MCP Server exposes `list_properties` and `search_properties` to let your OpenAI Agents SDK hunt down real estate investment properties. By connecting this endpoint, your OpenAI Agents SDK filters Mashvisor listings by city, zip, and bedroom count. The built-in guardrails in your OpenAI Agents SDK ensure the agent never requests out-of-bounds geographic data or triggers runaway Mashvisor search loops. You get clean, pre-filtered lists of Mashvisor assets directly in your OpenAI Agents SDK loop. If your OpenAI Agents SDK agent tries to pull raw Mashvisor data outside your defined safety parameters, the SDK blocks the action before execution. This gives you safe, automated property sourcing backed by hard Mashvisor metrics.
Side-by-side ROI analysis using agent handoffs
This MCP Server connects `get_rental_rates` and `get_investment_analysis` to your OpenAI Agents SDK for side-by-side real estate ROI calculations. Let one OpenAI Agents SDK agent pull traditional lease estimates while another digs into short-term performance. The OpenAI Agents SDK manages these specialized agents, handing off tasks to compare long-term cash flow against Mashvisor vacation rental metrics. This multi-agent setup keeps your OpenAI Agents SDK code clean when evaluating Mashvisor portfolios. Instead of one massive script, you have focused OpenAI Agents SDK agents passing structured Mashvisor data back and forth. You watch the entire handoff and calculation chain unfold in your OpenAI tracing dashboard.
Deep-dive historical checks for seasonal cash flow
This MCP Server provides `get_historical_performance` and `get_airbnb_property` to give your OpenAI Agents SDK deep historical context on rental properties. Short-term rentals live and die by seasonality, which is why your OpenAI Agents SDK agent needs historical Mashvisor context. Your OpenAI Agents SDK agent analyzes these patterns to flag Mashvisor properties that look highly profitable in July but drain cash in January. All of these Mashvisor API calls are cached on your OpenAI Agents SDK side when you set cacheToolsList to true. This keeps your OpenAI Agents SDK agent fast and prevents unnecessary overhead during large-scale Mashvisor market scans. You get deep Mashvisor historical context without sacrificing OpenAI Agents SDK run-time performance.
Set up Mashvisor 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 Mashvisor tools at runtime. - 3
Create your Agent
Pass the MCP to
Agent(mcp_servers=[server]). The agent receives Mashvisor tools as native definitions — JSON schemas resolve automatically. - 4
Run the agent
Call
Runner.run(agent, prompt)to execute. The agent invokes the appropriate Mashvisor 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="Mashvisor Agent",
instructions="You have access to Mashvisor 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 Mashvisor. 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 Mashvisor 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 Mashvisor MCP today
We host it, we monitor it, we maintain it. You just paste one token.
