Aamangeldi Dad Jokes MCP

What aamangeldi-dad-jokes-mcp MCP server does

The aamangeldi-dad-jokes-mcp MCP server exposes dad-joke retrieval through the Model Context Protocol. It uses icanhazdadjoke.com as its content source and gives an MCP client three operations: request a random joke, search jokes by a term, or retrieve one joke when its identifier is known.

This fits assistants, demonstrations, chat interactions, and other workflows that need short joke content. It does not provide a general content-management system or a local joke database; requests are served through the referenced external API.

How it works

The server is implemented in Python with FastMCP. When an MCP client invokes a tool, the server makes the corresponding request to icanhazdadjoke.com and returns the result through MCP. No API key is needed, and the service follows the rate limits set by icanhazdadjoke.com.

The random-joke operation takes no arguments. The search operation requires a string term and can optionally receive a limit. The documented default search limit is five results, while the maximum is 30. The ID lookup operation requires the target joke's string identifier.

Setup and configuration

To run the aamangeldi-dad-jokes-mcp MCP server locally, use Python 3.11 or newer and pip. Clone the repository, enter its directory, create a virtual environment, and install the listed packages: fastmcp, smithery, and httpx. After activating the environment, start the server with fastmcp run server.py.

The server has no required environment variables, authentication settings, or API-key configuration. Its default upstream endpoint is https://icanhazdadjoke.com. The README also describes Smithery deployment: connect the GitHub repository to Smithery, which detects the configuration and deploys it using the Python runtime settings.

Tools and capabilities

• get_random_joke_tool returns a random dad joke and accepts an empty argument object.
• search_jokes_tool finds jokes containing a supplied term. Provide term as a string; limit is optional and defaults to five, with a maximum of 30.
• get_joke_by_id_tool returns a specific joke. Provide its identifier in the required joke_id field.

These tools cover selection by randomness, text matching, and stable ID lookup. The source material does not document additional filters, write operations, user accounts, or joke submission features.

Limitations and notes

The aamangeldi-dad-jokes-mcp MCP server depends on icanhazdadjoke.com, so availability and request limits are governed by that service. It requires network access to retrieve content and does not list an offline mode or caching behavior. Search is term-based as documented; the README does not specify ranking, matching rules, pagination, or response formatting beyond the available limit.

The project is licensed under the MIT License. The README credits icanhazdadjoke.com for the jokes.