home / mcp / chuck norris jokes mcp server

Chuck Norris Jokes MCP Server

Provides a single MCP tool that returns random Chuck Norris jokes from a public API with asynchronous handling.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "alexulag-jokes-mcp": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

This MCP server exposes a simple, asynchronous tool that fetches random Chuck Norris jokes from a public API. It runs locally as a server you can query from any compatible MCP client, providing a lightweight way to integrate humor into your apps or demos.

How to use

To use the Chuck Norris Jokes MCP Server, start the server on your machine and connect a compatible MCP client. The server exposes a single tool named chistecitos that returns a random Chuck Norris joke when called without parameters. Use your MCP client to invoke this tool and display or process the joke in your application.

How to install

Prerequisites to run this server are Python 3.9 or higher and pip for package management.

Clone the project and navigate into the project directory.

git clone <url-del-repositorio>
cd jokes-mcp

Install the required dependencies from the requirements file.

pip install -r requirements.txt

Start the MCP server using Python.

python server.py

Additional notes

The server uses an asynchronous HTTP client under the hood to fetch jokes and includes basic error handling to keep the service responsive.

Package and runtime details: this server relies on the Python MCP SDK and the public Chuck Norris API for content.

Available tools

chistecitos

Asynchronous MCP tool that returns a random Chuck Norris joke by calling the public Chuck Norris API. It handles errors and exposes a simple interface for MCP clients.