How to Use the Mattermark MCP in OpenAI Agents SDK

Q: How do I connect Mattermark data to my OpenAI Agents SDK project?

You instantiate an MCPServerStreamableHttp object and pass it to your agent's configuration. The SDK handles discovery, letting you call any of the 10 tools immediately.

Q: Can my OpenAI Agents SDK agent handle high-volume data requests?

Yes, but keep an eye on your Mattermark API limits. Use cacheToolsList=True to shave off overhead during repeated agent loops.

Integrate startup intelligence into your OpenAI Agents SDK production workflows with direct access to Mattermark data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mattermark MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated startup intelligence retrieval

Stop guessing valuations and start pulling hard numbers. Your agent connects directly to the API to execute `get_company_details` and `get_company_funding_rounds` without manual intervention. Your production agent monitors cap tables and growth metrics in real-time. By utilizing `search_companies`, your system identifies high-signal targets before the rest of the market catches on.

Traceable venture capital analysis

Every action taken by your agent is logged and validated within your OpenAI dashboard. When your agent calls `get_investor_details`, the request is tracked alongside your internal safety guardrails. Hand off complex research tasks between specialized agents. One agent gathers data via `list_investors`, while another interprets the signal, ensuring your pipeline remains consistent and auditable.

Competitive landscape mapping

Identify market movements by checking how companies stack up against their peers. Use `list_similar_companies` to automatically map out the competitive set for any entity you are tracking. Your agent cross-references this with `get_company_news` to build a narrative of market shifts. It’s raw, unfiltered data delivered straight into your agent’s context window.

Setup guide

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

Create your Agent

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

Run the agent

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

You instantiate an `MCPServerStreamableHttp` object and pass it to your agent's configuration. The SDK handles discovery, letting you call any of the 10 tools immediately.

Yes, but keep an eye on your Mattermark API limits. Use `cacheToolsList=True` to shave off overhead during repeated agent loops.

The server uses a zero-trust architecture. Your credentials stay local, and data flows only through the authenticated MCP tunnel you define.

The tool returns an empty set, which your agent logic should handle. Always check the response schema before letting the agent proceed to the next step.

It exposes company funding rounds and investor details. The server strictly enforces the permissions defined by your API 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