English Français العربية

ai.smithery/aamangeldi-dad-jokes-mcp

Official registry Search and web

Get a random dad joke or search by keyword to fit any moment. Retrieve specific jokes by ID for re…

Source code Documentation

What can you do with ai.smithery/aamangeldi-dad-jokes-mcp?

  • 🎭 Get random dad jokes
  • 🔍 Search jokes by keyword
  • 🆔 Retrieve specific jokes by ID
  • ⚡ Fast and lightweight
  • 🚀 Ready for Smithery deployment

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http aamangeldi-dad-jokes-mcp 'https://server.smithery.ai/@aamangeldi/dad-jokes-mcp/mcp' --header 'Authorization: <Bearer token for Smithery authentication>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "aamangeldi-dad-jokes-mcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@aamangeldi/dad-jokes-mcp/mcp",
            "headers": {
                "Authorization": "<Bearer token for Smithery authentication>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Dad Jokes MCP Server
  2. Features
  3. Tools
  4. Local Development
  5. Deployment to Smithery
  6. Configuration
  7. Credits
  8. License

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:

{
  "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
  1. Clone the repository: bash git clone https://github.com/aamangeldi/dad-jokes-mcp.git cd dad-jokes-mcp
  2. Create a virtual environment and install dependencies: bash python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install fastmcp smithery httpx
  3. Run the server locally: bash fastmcp run server.py

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

Frequently asked questions

What is ai.smithery/aamangeldi-dad-jokes-mcp?

Get a random dad joke or search by keyword to fit any moment. Retrieve specific jokes by ID for re…

How do I install ai.smithery/aamangeldi-dad-jokes-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http aamangeldi-dad-jokes-mcp 'https://server.smithery.ai/@aamangeldi/dad-jokes-mcp/mcp' --header 'Authorization: <Bearer token for Smithery authentication>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ai.smithery/aamangeldi-dad-jokes-mcp need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is ai.smithery/aamangeldi-dad-jokes-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ai.smithery/aamangeldi-dad-jokes-mcp?

It is published by aamangeldi. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.