random-number-fact MCP Server

Fetch interesting, real-world facts or trivia about a given number — including historical events, mathematics, or fun facts — directly from numbersapi.com, using the Model Context Protocol (MCP).

Features

• Fetch trivia, math, date, or year facts about any integer.
• Supports random facts and specific number lookups.
• Robust error handling, production-ready.

Installation

You can use npx (recommended):

npx @dennisk2025/random-number-fact

Or install globally via npm:

npm install -g @dennisk2025/random-number-fact

Adding to Claude Desktop

Add the following configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "randomnumberfact": {
      "command": "npx",
      "args": ["@dennisk2025/random-number-fact"]
    }
  }
}

Add this to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Usage & Example Tools

Tool: get_number_fact

Fetches a random or specific fact about any integer. Supports multiple types:

Parameters:

• number (integer, optional): The number to fetch a fact for. Omit for random.
• type (string, optional): One of trivia, math, date, year, or random. Default: trivia.

Examples:

1. Get a random trivia fact:

Name: get_number_fact
Arguments: {}

2. Fact about the number 42 (default trivia):

Name: get_number_fact
Arguments: { "number": 42 }

3. Math fact about 17:

Name: get_number_fact
Arguments: { "number": 17, "type": "math" }

4. Fact about year 1984:

Name: get_number_fact
Arguments: { "number": 1984, "type": "year" }

5. Fact about March 14 (Pi Day, as MM/DD):

Name: get_number_fact
Arguments: { "number": "3/14", "type": "date" }

6. Completely random fact (random type/number):

Name: get_number_fact
Arguments: { "type": "random" }

Available Tools

get_number_fact

• Returns an interesting fact about a number. Parameters:
  • number (integer or string for "date" type, optional): Number to fetch fact for. Accepts MM/DD for date facts, or YYYYMMDD (auto-converted).
  • type (string, optional): "trivia", "math", "date", "year", or "random". Default: "trivia".

Start generating fun number facts for anything from your Claude Desktop conversations!