How to Use the Haystack (deepset Cloud) MCP in OpenAI Agents SDK

Q: Can I use Haystack (deepset Cloud) with OpenAI Agents SDK to search files?

Yes. You connect the server and call the searchdocuments tool to query your index. It passes results straight into your agent's context window.

Q: Does Haystack (deepset Cloud) work with OpenAI Agents SDK for pipeline management?

It does. You can list your active pipelines using listpipelines and then execute the ones you need via runpipeline.

Q: How do I verify workspace access for Haystack (deepset Cloud) in OpenAI Agents SDK?

Call listworkspaces after initialization. If the connection is active, you will see a list of your available cloud environments returned as JSON.

Connect your OpenAI Agents SDK production system to deepset Cloud for reliable RAG and document retrieval.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Haystack (deepset Cloud) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Haystack (deepset Cloud) 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 Haystack (deepset Cloud) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Execute RAG pipelines directly

Trigger your search logic without leaving the OpenAI Agents SDK environment. Use `run_pipeline` to process requests against your indexed data immediately. This keeps your agent loop tight. You avoid custom plumbing and rely on the native connection to handle the heavy lifting.

Manage your Haystack (deepset Cloud) workspace

Keep track of your environment state by calling `list_workspaces` and `list_pipelines`. You get an accurate view of what is available for your agent to use. No guessing which index is active. You query the metadata directly and ensure your agent targets the correct configuration.

Search indexed documents

Perform precise lookups across your internal files with `search_documents`. It gives your agent the specific context needed for grounded, accurate responses. Use `list_files` to verify your assets first. This prevents blind queries and ensures you are working with the right source material.

Setup guide

Set up Haystack (deepset Cloud) 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 Haystack (deepset Cloud) tools at runtime.
3

Create your Agent

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

Run the agent

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

Yes. You connect the server and call the `search_documents` tool to query your index. It passes results straight into your agent's context window.

It does. You can list your active pipelines using `list_pipelines` and then execute the ones you need via `run_pipeline`.

Call `list_workspaces` after initialization. If the connection is active, you will see a list of your available cloud environments returned as JSON.

All tool calls are handled by the MCP protocol. Check your OpenAI dashboard logs to see the specific inputs passed to `search_documents`.

The server operates on a per-request basis with your unique endpoint token. It only accesses the documents you explicitly authorize via the tool calls.

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