How to Use the Yodiz MCP in OpenAI Agents SDK

Q: How do I search for projects using Yodiz and OpenAI Agents SDK?

Use listprojects first. This tool pulls a list of all active agile projects in your entire Yodiz account, giving you the necessary IDs to continue.

Q: Can I get all bugs for a specific project with Yodiz and OpenAI Agents SDK?

Yep. Just use listbugs and provide it with the correct numeric Project ID. It returns every recorded issue attached to that particular development effort.

Q: Does this MCP Server help me manage sprints in Yodiz and OpenAI Agents SDK?

Absolutely. The listsprints tool pulls all iterations for a project. This lets your agent know exactly which time boxes are running or have finished.

Q: How does the MCP Server list who is working on what in Yodiz and OpenAI Agents SDK?

You can check user details with listusers to get all registered accounts. Then, pair that up by listing epics using listepics for context.

Get Yodiz project data fast with the OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Yodiz MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

List all projects using the MCP Server

The `list_projects` tool gives you a complete rundown of every agile project in your Yodiz account. You immediately know what work streams are active and where to point your agents. From that list, you can then use `list_sprints` to check all the iterations assigned to any specific project ID.

Checking user stories with OpenAI Agents SDK

Need details on a feature? The `list_user_stories` tool provides user story data if you hand it the numeric project ID. It's quick, giving you exactly what you need without wading through pages of notes. You can also run `list_bugs` to pull together all recorded issues for that same project, keeping your tracking process totally contained.

Managing users and epics via MCP Server

The `list_users` tool reads every registered user in the Yodiz workspace. This is useful if you're building an agent that needs to know who has access or ownership of certain records. Pairing this up, the `list_epics` tool shows high-level features for a project, giving context to the individual bugs and stories your agent finds.

Setup guide

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

Create your Agent

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

Run the agent

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

Use `list_projects` first. This tool pulls a list of all active agile projects in your entire Yodiz account, giving you the necessary IDs to continue.

This server touches structured records like Projects, User Stories, Bugs, and Users. Your agent can read these details but doesn't change the underlying user account information.

Yep. Just use `list_bugs` and provide it with the correct numeric Project ID. It returns every recorded issue attached to that particular development effort.

Absolutely. The `list_sprints` tool pulls all iterations for a project. This lets your agent know exactly which time boxes are running or have finished.

You can check user details with `list_users` to get all registered accounts. Then, pair that up by listing epics using `list_epics` for context.

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