How to Use the Worksection MCP in OpenAI Agents SDK

Q: What if I need to check past activity logs using Worksection with OpenAI Agents SDK?

You can call listworkhistory directly. This gives you a clear event log, so your agent knows exactly what happened and when it happened across the entire project's history.

Q: Can I find out who is on a specific project using Worksection with OpenAI Agents SDK?

Absolutely. Use the listprojectmembers tool. It pulls the exact team roster for any given work section, ensuring your agent only interacts with authorized personnel.

Manage your whole team's work history using 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 Worksection MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Track and Manage Workflows

The agent can list all available workspaces using `list_projects` or pull deep project context with `get_project_details`. You never have to manually jump between different work areas; your AI client handles the navigation. It also keeps tabs on specific jobs. Need a status update? Use `get_task_details` for full task information, and if it's finished, you can mark it done with `complete_task`.

Real-time Time Tracking

Managing time shouldn't be a mess. The agent monitors active timers via `list_active_timers`. When the work is finally over, you just tell it to stop tracking with `stop_timer`, and that data gets logged immediately. It handles more than just stopping the clock; you can check what happened in the past using `list_work_history` for a full event log.

Team Roster Management

If you're building an agent that needs to coordinate people, it knows who's involved. The MCP Server lets your client list all company users using `list_all_users`. You can also narrow the focus down by getting a roster of specific team members on any project via `list_project_members`. This makes sure your agents only interact with the right people and data sets.

Setup guide

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

Create your Agent

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

Run the agent

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

The OpenAPI Agent framework auto-discovers all tools on the MCP Server, so you don't have to write boilerplate code. You just pass the server endpoint, and your agent knows how to use tools like `create_task` or `get_project_details` out of the box.

You can call `list_work_history` directly. This gives you a clear event log, so your agent knows exactly what happened and when it happened across the entire project's history.

Yes. If a task gets accidentally archived or deleted, you can use `reopen_task` to bring that job back into active circulation for the team.

The server touches project and task metadata, including user IDs (from `list_all_users`) and time entries generated when tracking work via `stop_timer`.

Absolutely. Use the `list_project_members` tool. It pulls the exact team roster for any given work section, ensuring your agent only interacts with authorized personnel.

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