How to Use the Jokes API (API Ninjas) MCP in OpenAI Agents SDK

Q: How do I configure the Jokes API (API Ninjas) inside an OpenAI Agents SDK project?

Install the SDK via pip, configure MCPServerStreamableHttp with your Vinkius endpoint, and pass it to your Agent's mcpservers list to auto-discover getrandomjoke.

Q: Can my OpenAI Agents SDK system cache the tools list for Jokes API (API Ninjas)?

Yes, set cacheToolsList=True inside the connection parameters so your OpenAI Agents SDK doesn't re-query the getrandomjoke schema on every turn.

Q: How does the OpenAI Agents SDK handle rate limits when calling Jokes API (API Ninjas)?

You can monitor the API Ninjas limits by routing checkapistatus telemetry to your OpenAI developer dashboard, allowing you to catch 429 errors before they break your conversational flow.

Equip your OpenAI Agents SDK system with on-demand humor using this Jokes API (API Ninjas) MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Jokes API (API Ninjas) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Jokes API (API Ninjas) 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 Jokes API (API Ninjas) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated humor sourcing via OpenAI Agents SDK

The `get_random_joke` tool lets your OpenAI Agents SDK register and fetch comedic relief instantly based on user mood. Your agent can now pull jokes directly from the Jokes API (API Ninjas) using our MCP interface. By setting `cacheToolsList=True` in your OpenAI Agents SDK setup, the agent avoids repetitive schema lookups when pulling API Ninjas jokes.

Uptime monitoring with built-in safety guardrails

The `check_api_status` tool lets your OpenAI Agents SDK run validation rules to confirm the external endpoint is alive before attempting to fetch a joke. This blocks execution if the API status check returns a failing code. This setup prevents broken `get_random_joke` calls from cluttering your agent's execution history, letting you trace every status check directly in the OpenAI developer dashboard.

Safe agent handoffs for content moderation

Because API Ninjas serves raw jokes, the `get_random_joke` tool lets you route the output to a specialized moderation agent in your OpenAI Agents SDK pipeline. This MCP Server allows a supervisor agent to inspect the joke text before displaying it to the user. If a joke fails your safety rules, the OpenAI Agents SDK handles the fallback gracefully instead of crashing your application.

Setup guide

Set up Jokes API (API Ninjas) 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 Jokes API (API Ninjas) tools at runtime.
3

Create your Agent

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

Run the agent

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

Install the SDK via pip, configure `MCPServerStreamableHttp` with your Vinkius endpoint, and pass it to your Agent's `mcp_servers` list to auto-discover `get_random_joke`.

Yes, set `cacheToolsList=True` inside the connection parameters so your OpenAI Agents SDK doesn't re-query the `get_random_joke` schema on every turn.

You can monitor the API Ninjas limits by routing `check_api_status` telemetry to your OpenAI developer dashboard, allowing you to catch 429 errors before they break your conversational flow.

Yes, the OpenAI Agents SDK supports async context managers, letting you call `get_random_joke` concurrently without blocking other conversational tasks.

The integration only sends your API key and the count parameter to the Jokes API (API Ninjas) endpoint. Vinkius runs the server in an isolated, ephemeral sandbox, ensuring your broader agent state and conversational history never leak to the external API.

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