This is a Model Context Protocol (MCP) server that provides access to the Chuck Norris Jokes API. It allows AI assistants like Claude to fetch and search for Chuck Norris jokes.
- Get random Chuck Norris jokes
- Get jokes from specific categories
- List all available joke categories
- Search for jokes by text
The MCP server provides the following tools:
get-random-joke
- Fetches a random Chuck Norris jokeget-joke-from-category
- Fetches a random joke from a specified categoryget-categories
- Lists all available joke categoriessearch-jokes
- Searches for jokes containing specific text
The server is designed to be deployed on Vercel. You can deploy it with the following steps:
- Fork or clone this repository
- Deploy to Vercel with
vercel deploy
- Once deployed, you can use the deployed URL as an MCP server in compatible clients
You can test the MCP server using any MCP-compatible client. Here's an example using the MCP CLI:
npx @modelcontextprotocol/[cli your-vercel-deployment-url](https://mcp-chuck-norris.vercel.app/)
- Jokes provided by api.chucknorris.io
- Built with the Model Context Protocol
- Hosted on Vercel