How to Use the GeekJoke MCP in Mastra AI

Q: How do I connect the GeekJoke MCP Server to Mastra AI?

Install the package using npm install @mastra/mcp@latest in your project. Instantiate the MCPClient with the Vinkius SSE or HTTP URL, then pass the tools to your Mastra agent. The framework automatically discovers the available joke endpoints.

Build resilient agent workflows that fetch and process programming humor with Mastra AI and this 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 GeekJoke MCP to Mastra AI

Create your Vinkius account to connect GeekJoke to Mastra AI 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 GeekJoke with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate humor loops with Mastra AI

The `get_random_joke` tool retrieves a programming joke that your Mastra AI agent can use to break the ice in a developer Slack channel. Our workflow engine handles the execution, letting you schedule GeekJoke delivery at specific intervals. If the initial GeekJoke API call fails, Mastra's built-in exponential backoff retries the request automatically. Your users never see a broken message, only the joke when the connection recovers.

Check server metadata before running workflows

The `get_metadata` tool fetches the operational status of the GeekJoke endpoint to verify it is online. This tool integrates directly into your Mastra AI conditional branching steps. If the metadata check returns an error, your Mastra AI workflow bypasses the GeekJoke step entirely. Such checks prevent your agent from getting stuck in an infinite loop when external APIs go down.

Retrieve jokes via POST inside agent workflows

The `generate_random_joke` tool uses a secure POST request to fetch a random GeekJoke for your automated workflows. It provides a reliable backup path if your network blocks outbound GET requests. You register this tool by spreading `listTools()` from the MCP Client into your Mastra AI agent configuration. The framework handles the JSON parsing and delivers the clean GeekJoke string directly to the next workflow step.

Setup guide

Set up GeekJoke MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All GeekJoke tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "geekjoke-mcp-client",
  servers: {
    "geekjoke-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "GeekJoke Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to GeekJoke tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent GeekJoke transactions"
);
console.log(result.text);

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 GeekJoke. 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 GeekJoke 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 GeekJoke MCP in Mastra AI

Install the package using `npm install @mastra/mcp@latest` in your project. Instantiate the `MCPClient` with the Vinkius SSE or HTTP URL, then pass the tools to your Mastra agent. The framework automatically discovers the available joke endpoints.

Yes, you can use Mastra's human-in-the-loop feature by setting `requireToolApproval` on the agent. This pauses the workflow and lets you review the joke before it gets sent to your team. It keeps the humor work-safe.

The workflow engine uses automatic retries to handle rate limits gracefully. If the server returns a temporary error, the agent backs off and tries again later. You don't need to write custom error-handling code.

This MCP Server supports both SSE and Streamable HTTP transports. Mastra AI auto-detects the active protocol when you initialize the client. You only need to supply the connection URL from your Vinkius dashboard.

The server only touches basic API metadata and outbound joke requests. Your private workflow configurations, environment secrets, and agent memory are never exposed to the external network. Vinkius runs the server in an ephemeral sandbox to prevent data leaks.

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