{
  "markdown": "# Dad Jokes MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@aamangeldi/dad-jokes-mcp)](https://smithery.ai/server/@aamangeldi/dad-jokes-mcp)\n\nA lightweight Model Context Protocol (MCP) server that provides dad jokes from [icanhazdadjoke.com](https://icanhazdadjoke.com).\n\n## Features\n\n- 🎭 Get random dad jokes\n- 🔍 Search jokes by keyword\n- 🆔 Retrieve specific jokes by ID\n- ⚡ Fast and lightweight\n- 🚀 Ready for Smithery deployment\n\n## Tools\n\n### `get_random_joke_tool`\nGet a random dad joke.\n\n**Example:**\n```json\n{}\n```\n\n### `search_jokes_tool`\nSearch for dad jokes containing a specific term.\n\n**Parameters:**\n- `term` (string, required): Search term to find jokes\n- `limit` (integer, optional): Number of jokes to return (default: 5, max: 30)\n\n**Example:**\n```json\n{\n  \"term\": \"pizza\",\n  \"limit\": 3\n}\n```\n\n### `get_joke_by_id_tool`\nRetrieve a specific joke by its ID.\n\n**Parameters:**\n- `joke_id` (string, required): The ID of the joke to retrieve\n\n**Example:**\n```json\n{\n  \"joke_id\": \"R7UfaahVfFd\"\n}\n```\n\n## Local Development\n\n### Prerequisites\n- Python 3.11+\n- pip\n\n### Setup\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/aamangeldi/dad-jokes-mcp.git\ncd dad-jokes-mcp\n```\n\n2. Create a virtual environment and install dependencies:\n```bash\npython3 -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\npip install fastmcp smithery httpx\n```\n\n3. Run the server locally:\n```bash\nfastmcp run server.py\n```\n\n## Deployment to Smithery\n\n1. Push your code to GitHub\n2. Connect your repository to [Smithery](https://smithery.ai)\n3. Smithery will automatically detect the configuration and deploy your server\n\nThe server uses:\n- `runtime: python` in `smithery.yaml`\n- FastMCP for the server implementation\n- `@smithery.server()` decorator for configuration\n\n## Configuration\n\nThe server requires no authentication or configuration. It uses the free icanhazdadjoke.com API with the following defaults:\n- API: `https://icanhazdadjoke.com`\n- No API key required\n- Rate limiting follows icanhazdadjoke.com policies\n\n## Credits\n\nDad jokes provided by [icanhazdadjoke.com](https://icanhazdadjoke.com)\n\n## License\n\nMIT License - see LICENSE file for details\n",
  "bytes": 2198,
  "sha": "44c3459c04a580e6ae59abffaea586892d4f1bb9aa16f3906c19d7ee6c93243f",
  "repo_slug": "aamangeldi/dad-jokes-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_smithery_aamangeldi_dad_jokes_mcp_1baf759e/readme"
}