How to Use the Jservice MCP in OpenAI Agents SDK

Q: How do I connect the Jservice server to my OpenAI Agents SDK project?

Install the SDK, then create an MCPServerStreamableHttp instance with your Vinkius endpoint URL. Pass this server object into the Agent constructor's mcpservers list. The agent handles the rest automatically.

Q: Is there a limit to how many random clues I can get?

Yes, the getrandomclues tool is capped at 100 clues per call. This prevents your agent from accidentally requesting a huge dataset and slowing down your application.

Build production trivia agents with the OpenAI Agents SDK. Your agent gets validated, traceable access to the Jservice database.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Jservice MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Trivia Categories and Clues

The `get_categories` tool pulls a list of Jeopardy! categories your agent can work with. You get up to 100 at a time, so you can quickly populate a game board or give the user options. The `get_category` tool then drills down, fetching all clues for a specific category ID. Once your agent has a category, it can use the `get_clues` tool to find specific questions. Filter by value, date, or offset to build rounds with escalating difficulty. The OpenAI SDK's guardrails mean your agent won't ask for a category that doesn't exist, preventing wasted API calls.

Generate Random Trivia Questions

Use the `get_random_clues` tool to pull a random set of questions for quick-fire trivia rounds. It's perfect for building a chatbot that can drop a trivia question on command without needing a category first. You can request up to 100 clues in a single call. This is where the OpenAI Agents SDK really shines. Your agent can decide when a random question is appropriate, and the framework's tracing gives you a full audit trail. You'll see exactly why it chose `get_random_clues` and what it did with the result, right in the OpenAI dashboard.

Safe Trivia Actions with OpenAI Agents SDK

This Jservice MCP Server isn't just about data; it's about controlled actions. The tools are auto-discovered by your agent, so there's zero setup to map functions. Just point it at the server endpoint and set `cacheToolsList=True` for better performance. Because the SDK validates actions before execution, your agent's behavior stays predictable. If it tries to use `get_clues` with a bad filter, the action is blocked before it ever hits the API. This is critical for a deployed product that can't afford runtime errors.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the SDK, then create an `MCPServerStreamableHttp` instance with your Vinkius endpoint URL. Pass this server object into the `Agent` constructor's `mcp_servers` list. The agent handles the rest automatically.

Yes. The OpenAI Agents SDK automatically discovers and registers `get_categories`, `get_category`, `get_clues`, and `get_random_clues`. You don't need to define them manually; they're ready to use once you connect the server.

Just ask your agent to 'get a list of trivia categories.' It will know to invoke the `get_categories` tool. The tool returns up to 100 categories per request, giving your agent plenty of options to work with.

Yes, the `get_random_clues` tool is capped at 100 clues per call. This prevents your agent from accidentally requesting a huge dataset and slowing down your application.

This server only interacts with public Jeopardy! trivia data—specifically, clues and categories. No user data is ever touched or stored. Your connection is secured through the Vinkius endpoint token, and all operations run in an ephemeral, zero-trust sandbox.

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