Summary
Connects to the icanhazdadjoke.com API and wraps three simple operations: pull random dad jokes, search the joke database by keyword with configurable result limits, or fetch specific jokes by ID. You'd reach for this when building conversational AI that needs levity on demand, whether that's breaking tension in a support chat, filling dead air, or responding to user requests for humor. The search tool is the most practical bit since you can match jokes to context (search "pizza" when discussing food orders, for instance). No auth required, runs on FastMCP, and deploys to Smithery with zero configuration. It's a single purpose tool that does exactly what the tin says.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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 jokeslimit(integer, optional): Number of jokes to return (default: 5, max: 30)
Example:
{
"term": "pizza",
"limit": 3
}
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:
{
"joke_id": "R7UfaahVfFd"
}
Local Development
Prerequisites
- Python 3.11+
- pip
Setup
- Clone the repository:
git clone https://github.com/aamangeldi/dad-jokes-mcp.git
cd dad-jokes-mcp
- Create a virtual environment and install dependencies:
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install fastmcp smithery httpx
- Run the server locally:
fastmcp run server.py
Deployment to Smithery
- Push your code to GitHub
- Connect your repository to Smithery
- Smithery will automatically detect the configuration and deploy your server
The server uses:
runtime: pythoninsmithery.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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
TransportHTTP
AuthRequired
UpdatedSep 30, 2025
