@dennisk2025/random-space-object-facts
v1.0.0
Published
Fetches a random fun fact about a planet or other celestial body in our solar system, helping users learn cool space trivia from real data.
Readme
random-space-object-facts
Fetches a random fun fact about a planet or other significant celestial body (such as moons and dwarf planets) in our solar system. Uses real data from the le-systeme-solaire.net open API to deliver space trivia in the form of short, interesting facts.
Features
- One-shot tool: get_random_space_object_fact
- Returns a random, accurate fact about a planet, moon, dwarf planet, or asteroid in the solar system
- Facts may include discovery info, physical properties, orbits, moons, and more
- Powered by the public le-systeme-solaire.net database (no API key needed)
Installation
With npm:
npm install -g @dennisk2025/random-space-object-facts
Or via npx:
npx @dennisk2025/random-space-object-facts
Adding to Claude Desktop
To use this MCP server in Claude Desktop, add the following to your claude_desktop_config.json configuration:
{
"mcpServers": {
"spacefacts": {
"command": "npx",
"args": ["@dennisk2025/random-space-object-facts"]
}
}
}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
Restart Claude Desktop for changes to take effect.
Usage
Once added, Claude will be able to call the following tool:
Tool: get_random_space_object_fact
Description: Returns a random fact about a planet or significant celestial body (e.g. moons, dwarf planets) in our solar system, sourced from a public open database.
Parameters:
None. (No input fields.)
Example tool call from Claude:
- Tool name:
get_random_space_object_fact - Parameters:
{}
Example result:
{"name":"Jupiter","fact":"Jupiter is a planet. Its orbital period is around 4332.59 Earth days.","bodyType":"Planet","id":"jupiter"}Another possible result:
{"name":"Ceres","fact":"Ceres is a dwarf planet. It is classified as a dwarf planet.","bodyType":"Dwarf Planet","id":"ceres"}Available Tools
| Tool Name | Description | Parameters | |------------------------------|----------------------------------------------------------------------------------------|---------------| | get_random_space_object_fact | Returns a random fact about a planet or significant celestial body in our solar system. | None |
Parameters: This tool accepts no parameters (just pass an empty object {}).
