How to Use the Harmonic MCP in OpenAI Agents SDK

Q: How do I start using Harmonic with the OpenAI Agents SDK for startup discovery?

Just pass the Vinkius MCP server URL to the MCPServerStreamableHttp constructor. The OpenAI Agents SDK handles the rest, automatically discovering all 11 tools like searchstartups and making them available to your agent.

Q: What's the best way to enrich a list of domains using Harmonic and the OpenAI Agents SDK?

Have your agent loop through your list and call the enrichcompany tool for each domain. The SDK's async support handles this well. For performance, make sure you set cacheToolsList=True when you initialize the agent.

Build production-ready investment agents with Harmonic and the OpenAI Agents SDK. Stop prototyping and start shipping.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Harmonic MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Deal Sourcing

The `search_startups` tool lets your agent find companies based on industry, location, or size. You can feed it a list of target profiles and let it run. Your agent can then use `search_investors` to map out the key players in that space. Here’s the thing: the OpenAI Agents SDK has guardrails. It validates agent actions before they run. This means you can deploy an agent to actively source deals without worrying it will go off the rails and burn through your API budget. It’s a reliable way to keep your pipeline full.

Due Diligence on Autopilot

The `enrich_company` tool takes a domain and returns a full dossier. Your agent can get firmographics, social signals, and more. Then, it can dig deeper by calling `list_funding_rounds` and `list_company_news` to pull a company's full financial history and recent press. This isn't just about saving time. It's about consistency. An agent following this process won't miss a step. Every company gets the same initial background check, so your analysts can focus on the real work: deciding if the deal is any good.

Real-Time Tracking via MCP Server

Use the `list_traction_signals` tool to watch for hiring spikes, web traffic changes, and social media growth. Your agent can monitor a watchlist of startups and alert you the moment something interesting happens. You can also use `get_company_stats` for a snapshot of a company's headcount growth over time. Because this runs through a managed MCP Server, it's built for this kind of persistent monitoring. Set up a specialized agent in your multi-agent system to just watch for signals. It’s a far more direct way to spot breakouts before they show up on everyone else's radar.

Setup guide

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

Create your Agent

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

Run the agent

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

Just pass the Vinkius MCP server URL to the `MCPServerStreamableHttp` constructor. The OpenAI Agents SDK handles the rest, automatically discovering all 11 tools like `search_startups` and making them available to your agent.

Yes. When you kick off a background enrichment, you'll get a request ID. Your agent can then periodically call the `get_enrichment_status` tool with that ID to see if the data is ready.

Have your agent loop through your list and call the `enrich_company` tool for each domain. The SDK's async support handles this well. For performance, make sure you set `cacheToolsList=True` when you initialize the agent.

Absolutely. You can create a dedicated 'research' agent equipped with the Harmonic tools. Other agents can then hand off tasks like 'get the funding history for company X' to this specialist agent, keeping your agent roles clean and focused.

This server primarily works with company domains, person names, and investor names to fetch public business intelligence. Your requests are processed inside a Vinkius zero-trust sandbox. Every connection is ephemeral and isolated, and your access is managed through a single, revocable token.

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