{"_id":"@dennisk2025/timezone-lookup","name":"@dennisk2025/timezone-lookup","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/timezone-lookup","version":"1.0.0","description":"Looks up the current local time, UTC offset, and timezone name for any given city or geographical coordinate using the GeoNames Timezone API.","type":"module","main":"index.js","bin":{"timezone-lookup-mcp":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","node-fetch":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/timezone-lookup@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-r7kljNrGj2n/J6UgEjlp2JBiv5TtUMvhR+HeXwv/5JEVyHrH4Piccz2JWokXu91d0tDHhXMLKCres8eFdY43Bg==","shasum":"53dfdb1823f4e8d192cb375f635ea4bb965571e9","tarball":"https://registry.npmjs.org/@dennisk2025/timezone-lookup/-/timezone-lookup-1.0.0.tgz","fileCount":3,"unpackedSize":11004,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHw1TpHmrTbWDzuV5hvNJJnik/al+qKEUB40NCqEkFB9AiB8dbfkE59+GX0CTDSQpA66/OKLRVtLYqwoBo4BRos5Tg=="}]},"_npmUser":{"name":"dennisk2025","email":"4dennisk@gmail.com"},"directories":{},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/timezone-lookup_1.0.0_1761426771250_0.6922200378437418"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T21:12:51.184Z","1.0.0":"2025-10-25T21:12:51.423Z","modified":"2025-10-25T21:12:51.672Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Looks up the current local time, UTC offset, and timezone name for any given city or geographical coordinate using the GeoNames Timezone API.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# timezone-lookup-mcp\n\nLooks up the current local time, UTC offset, and timezone name for any given city or geographical coordinate using the GeoNames Timezone API.\n\n## Features\n- Look up timezone, local time, and UTC offset by coordinates (latitude, longitude).\n- Look up timezone, local time, and UTC offset by city name (with optional 2-letter country code).\n- Uses the public [GeoNames Timezone API](http://www.geonames.org/export/web-services.html) and [GeoNames Search API](http://www.geonames.org/export/geonames-search.html) (no API key required for demo usage).\n\n---\n\n## Installation\n\n### Quick npx usage\n```\nnpx @dennisk2025/timezone-lookup-mcp\n```\n\n### Install locally (optional)\n```\nnpm install @dennisk2025/timezone-lookup-mcp\n```\n\n---\n\n## Adding to Claude Desktop\n\nAdd this configuration block to your Claude Desktop config file:\n\n```json\n{\n  \"mcpServers\": {\n    \"timezone\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/timezone-lookup-mcp\"]\n    }\n  }\n}\n```\n\nAdd this to your Claude Desktop config file at:\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n---\n\n## Usage\n\n### Tools Provided\n\n#### 1. `lookup_by_coordinates`\nGet the current local time and timezone information for a given latitude and longitude.\n\n**Parameters:**\n- `latitude` (`number`): Latitude of the location, e.g. `40.7128`\n- `longitude` (`number`): Longitude of the location, e.g. `-74.0060`\n\n**Example Call:**\n```json\n{\n  \"name\": \"lookup_by_coordinates\",\n  \"arguments\": {\n    \"latitude\": 35.6895,\n    \"longitude\": 139.6917\n  }\n}\n```\n\n\n#### 2. `lookup_by_city`\nGet the current local time and timezone information for a given city and (optionally) country code.\nUses GeoNames search API to resolve coordinates.\n\n**Parameters:**\n- `city` (`string`): Name of the city, e.g. `Paris`\n- `country_code` (`string`, optional): 2-letter country code, e.g. `FR`\n\n**Example Call:**\n```json\n{\n  \"name\": \"lookup_by_city\",\n  \"arguments\": {\n    \"city\": \"Berlin\",\n    \"country_code\": \"DE\"\n  }\n}\n```\n\n---\n\n## Example Tool Responses\n\n**lookup_by_coordinates (New York):**\n```json\n{\n  \"local_time\": \"2024-06-09 16:15\",\n  \"utc_offset\": -4,\n  \"timezone_name\": \"America/New_York\",\n  \"sunrise\": \"2024-06-09 05:24\",\n  \"sunset\": \"2024-06-09 20:27\"\n}\n```\n\n**lookup_by_city (Tokyo):**\n```json\n{\n  \"local_time\": \"2024-06-10 05:13\",\n  \"utc_offset\": 9,\n  \"timezone_name\": \"Asia/Tokyo\",\n  \"sunrise\": \"2024-06-10 04:24\",\n  \"sunset\": \"2024-06-10 18:56\",\n  \"coordinates\": { \"latitude\": 35.69, \"longitude\": 139.69 }\n}\n```\n\n---\n\n## Tool Summary\n\n**lookup_by_coordinates**\n- latitude (number, required)\n- longitude (number, required)\n\n**lookup_by_city**\n- city (string, required)\n- country_code (string, optional)\n\n---\n\n## API Rate Limits\n\nThis plugin uses the free/demo GeoNames API endpoints for demonstration and may be subject to rate limits or throttling. For higher usage, obtain a personal GeoNames username and update the API URLs in the source.\n","readmeFilename":"README.md","_rev":"1-9709b899c13265e44bc85aebdb88e526"}