Skip to main content
Glama
world-tools-mcp

world-tools-mcp

world-tools-mcp

A lightweight MCP server that gives Claude access to current time, weather, and moon phase data. Stateless — no database, no companion data. Calls open public APIs and returns results.

Part of the Nullsafe BBH suite.

⚠️ Disclaimer This project was built with AI assistance ("vibe-coded"). Security hardening has been applied to the best of our ability — API key auth, no data persistence, minimal attack surface — but this software comes with no warranty and no liability. It has not undergone a professional security audit. If you use it, you use it at your own risk.

Tools

Tool

Returns

get_time

Current time in UTC + any named timezone

get_weather

Current conditions via open-meteo (free, no API key required)

get_moon_phase

Lunar phase name, illumination %, age in days

Related MCP server: DateTime MCP Server

Quick setup (if you know what you're doing)

git clone https://github.com/your-github-user/world-tools-mcp.git
cd world-tools-mcp
npm install && npm run build
cp .env.example .env   # fill in API_KEY, WEATHER_LAT, WEATHER_LON
npm start

For VPS deployment, install the systemd unit (deploy/world-tools-mcp.service; see INSTALL.md) behind a Cloudflare Tunnel. Not pm2.

Not sure where to start? See INSTALL.md for step-by-step instructions.

Environment variables

Variable

Required

Description

API_KEY

Yes

Bearer token for MCP auth

WEATHER_LAT

Yes

Decimal latitude for weather

WEATHER_LON

Yes

Decimal longitude for weather

PUBLIC_URL

Yes

Full URL this server is reachable at

PORT

No

Server port (default: 3456)

DEFAULT_TIMEZONE

No

IANA timezone (e.g. America/New_York) so get_time returns local time by default instead of UTC. Falls back to the process TZ if set.

WEATHER_LAT and WEATHER_LON are required — the server refuses to start without them. Set DEFAULT_TIMEZONE too, or get_time will only report UTC unless the caller passes a timezone.

MCP tool namespace

mcp__claude_ai_world-tracker

Security

See SECURITY.md.

Acknowledgments

The original idea — a tiny MCP server bundling time, weather, and moon phase — comes from SweetSunnyBunny's Sharing-MCPs. This is an independent reimplementation (its own server/OAuth/transport code, plus fixes for a process crash-loop and a default-timezone bug), shared back in the same spirit. Thank you for the original idea. 🌙

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      The Time MCP Server is a Model Context Protocol (MCP) server that provides AI assistants and other MCP clients with standardized tools to perform time and date-related operations. This server acts as a bridge between AI tools and a robust time-handling back
      179 npm
      25
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      A simple MCP server that provides accurate date and time information to Claude models, ensuring they always use the correct current date and time when creating time-sensitive content.
      3
      -
    • A
      license
      A
      quality
      D
      maintenance
      An extensible MCP server with weather and time tools for Claude Desktop. It provides current time with automatic timezone detection, weather alerts for US states, and 5-period forecasts for coordinates.
      4
      MIT