Dad Jokes MCP Server

A lightweight Model Context Protocol (MCP) server that provides dad jokes from icanhazdadjoke.com.

Features

• 🎭 Get random dad jokes

• 🔍 Search jokes by keyword

• 🆔 Retrieve specific jokes by ID

• ⚡ Fast and lightweight

• 🚀 Ready for Smithery deployment

Tools

get_random_joke_tool

Get a random dad joke.

Example:

search_jokes_tool

Search for dad jokes containing a specific term.

Parameters:

• term (string, required): Search term to find jokes

• limit (integer, optional): Number of jokes to return (default: 5, max: 30)

Example:

get_joke_by_id_tool

Retrieve a specific joke by its ID.

Parameters:

• joke_id (string, required): The ID of the joke to retrieve

Example:

Local Development

Prerequisites

• Python 3.11+

• pip

Setup

1. Clone the repository:

2. Create a virtual environment and install dependencies:

3. Run the server locally:

Deployment to Smithery

1. Push your code to GitHub

2. Connect your repository to Smithery

3. Smithery will automatically detect the configuration and deploy your server

The server uses:

• runtime: python in smithery.yaml

• FastMCP for the server implementation

• @smithery.server() decorator for configuration

Configuration

The server requires no authentication or configuration. It uses the free icanhazdadjoke.com API with the following defaults:

• API: https://icanhazdadjoke.com

• No API key required

• Rate limiting follows icanhazdadjoke.com policies

Credits

Dad jokes provided by icanhazdadjoke.com

License

MIT License - see LICENSE file for details