@dennisk2025/random-fun-fact
v1.0.0
Published
Fetches a random, fun, real-world fact from the Useless Facts API. Each call returns a single quirky, surprising, or amusing fact, optionally specifying the language.
Readme
random-fun-fact-mcp
Fetches a random, fun, real-world fact from the Useless Facts API. Each call returns a single quirky, surprising, or amusing fact, optionally specifying the language (English or German).
Installation
Install globally using npm:
npm install -g @dennisk2025/random-fun-fact-mcpOr run instantly via npx (recommended for Claude Desktop):
npx @dennisk2025/random-fun-fact-mcpAdding to Claude Desktop
Add the following JSON snippet to your Claude Desktop config file at:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"random-fun-fact": {
"command": "npx",
"args": ["@dennisk2025/random-fun-fact-mcp"]
}
}
}Restart Claude Desktop and "random-fun-fact" will appear as a custom MCP tool.
Usage
This MCP provides one tool:
Tool: get_random_fun_fact
Returns a random fun fact in the specified language (English or German).
Parameters
language(optional):- Type: string
- Allowed values:
"en","de" - Description: The language code for the fact. 'en' for English, 'de' for German. Defaults to 'en'.
Usage Examples
English (default)
{
"name": "get_random_fun_fact",
"arguments": {}
}German
{
"name": "get_random_fun_fact",
"arguments": { "language": "de" }
}Response Example
{
"fact": "The unicorn is Scotland’s national animal.",
"language": "en"
}Available Tools
| Tool Name | Description | Parameters | |----------------------|--------------------------------------------------------------------------------|--------------------| | get_random_fun_fact | Returns a random fun fact (optionally specify language: 'en' or 'de'). | language (string) |
Notes
- No API keys required. All facts from uselessfacts.jsph.pl
- Safe for use in production or personal chats!
