How to Use the Jokes API (API Ninjas) MCP in Windsurf

Q: How do I configure the Jokes API (API Ninjas) inside Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the MCP Server configuration under the mcpServers key. Cascade will immediately detect the new tools and let you use them in your chat sessions.

Q: Can Cascade use Jokes API (API Ninjas) autonomously in Windsurf?

Yes, Cascade executes the getrandomjoke tool to populate your code templates without asking for permission. It plans the file edits, runs the tool, and inserts the content directly.

Q: How does Windsurf handle errors from Jokes API (API Ninjas)?

When a request fails, your MCP client uses checkapistatus to determine if the service is down. Cascade stops the execution chain and suggests alternative placeholder text.

Feed your Windsurf agent raw comedic material on demand so it can inject humor into your UI builds without you writing a line of code.

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 Windsurf

Create your Vinkius account to connect Jokes API (API Ninjas) to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Instantly fetch raw humor for UI prototypes

The `get_random_joke` tool pulls clean, unformatted comedic text directly into your active workspace. Your Windsurf agent calls this endpoint to populate empty states, loading screens, or dummy data fields with actual content instead of boring placeholder text. Cascade handles the entire process. It grabs the text, formats it as a JSON object, and writes it directly into your component files. You watch the code update in real time.

Verify endpoint health before running builds

The `check_api_status` tool verifies that the API Ninjas servers are up and responding before you trigger a deployment. If the connection fails, Windsurf halts the script and alerts you, preventing broken dependencies from hitting your staging environment. This direct check saves you from debugging ghost errors in your frontend code. Cascade runs this check autonomously as the first step in any testing sequence it plans for you.

Chain multi-step joke filtering inside this MCP Server

The `get_random_joke` tool serves as the starting point for autonomous content moderation chains within your workspace. Cascade pulls the raw joke, passes it to a local validation script, and rejects any content that fails your brand guidelines. This setup keeps your staging environments clean. Instead of manually reviewing every fetched string, you let your agent handle the verification pipeline on its own.

Setup guide

Set up Jokes API (API Ninjas) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Jokes API (API Ninjas) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Jokes API (API Ninjas) payment history." If connected, Cascade will call the Jokes API (API Ninjas) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "jokes-api-api-ninjas-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the MCP Server configuration under the `mcpServers` key. Cascade will immediately detect the new tools and let you use them in your chat sessions.

Yes, Cascade executes the `get_random_joke` tool to populate your code templates without asking for permission. It plans the file edits, runs the tool, and inserts the content directly.

When a request fails, your MCP client uses `check_api_status` to determine if the service is down. Cascade stops the execution chain and suggests alternative placeholder text.

Instruct Cascade to write a local caching function for your fetched jokes. This limits external requests and keeps your development loop fast.

This MCP integration only transmits your API keys and status checks to API Ninjas. Your local source code and project files stay completely within your secure local environment.

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