How to Use the JokeAPI MCP in Google ADK

Q: How do I restrict tool access in Google ADK?

Use the toolnames filter during initialization. This limits your agent to only the specific tools you want it to execute.

Connect Google ADK to JokeAPI. Build humor-aware agents on Google Cloud infrastructure with native tool support.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect JokeAPI MCP to Google ADK

Create your Vinkius account to connect JokeAPI to Google ADK 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 JokeAPI with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Tool execution in Google ADK

Your agent uses `get_joke` to pull content into its reasoning loop. It fits right into your existing Google Cloud agent infrastructure. Deployment is simple. The tool maps directly to your agent's toolset, letting you focus on the prompt engineering.

Filter categories for Google ADK

Call `list_joke_categories` to define which humor types your agent can access. This ensures your enterprise agent stays within brand guidelines. It prevents off-topic responses. You maintain full control over what the model sees and executes.

Fetch batch content via MCP Server

The `list_jokes` tool lets you grab multiple items at once. This is perfect for agents that need to analyze humor patterns across large datasets. It works reliably with the Google ADK architecture. You spend less time waiting and more time processing data.

Setup guide

Set up JokeAPI MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with JokeAPI tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="JokeAPI_agent",
    model="gemini-2.0-flash",
    instruction="You have access to JokeAPI tools via MCP.",
    tools=mcp_tools,
)

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 JokeAPI. 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 JokeAPI 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 JokeAPI MCP in Google ADK

You initialize the McpToolset with the server URL and pass it to your agent constructor. The tools become available for your agent to call immediately.

Yes, it provides clean text strings that fit perfectly into the Gemini context window. Your agent can process the data without hitting token limits.

The server works over HTTP, making it easy to host in your VPC. Your agent will reach the endpoint just like any other internal service.

Use the tool_names filter during initialization. This limits your agent to only the specific tools you want it to execute.

The server processes only public humor data. It does not access your BigQuery tables or any sensitive enterprise information.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.