{"_id":"@brainycalc/mcptimeserver","_rev":"8-e6c2b447d5ce1721a6fbd7cf8982148a","name":"@brainycalc/mcptimeserver","dist-tags":{"latest":"1.0.8"},"versions":{"1.0.0":{"name":"@brainycalc/mcptimeserver","version":"1.0.0","keywords":["mcp","time","date","calculator","model-context-protocol"],"license":"MIT","_id":"@brainycalc/mcptimeserver@1.0.0","maintainers":[{"name":"jonbill","email":"codibits@gmail.com"}],"bin":{"mcptimeserver":"src/index.js"},"dist":{"shasum":"66388ee42f3c56844fb0fa46a75195503ad3ff57","tarball":"https://registry.npmjs.org/@brainycalc/mcptimeserver/-/mcptimeserver-1.0.0.tgz","fileCount":5,"integrity":"sha512-bfd5GKa2Ra9HgWs/98xFb2Eq6K75ycg7fkZ1EB4a3H3rrSaRAuoP4pEysSX9zoaX32xipuEZ7b4nyuGOM3fbYw==","signatures":[{"sig":"MEYCIQChSJxvJZAoEe/IThcgxi8dNTfDH+aFOXMY/7Lbt80HBAIhAONK0f6GmwmOKkR7PYeS8OWP8IcPAodFlHTwsLsHgb9e","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":152086},"main":"src/index.js","type":"module","scripts":{"test":"node src/test.js","start":"node src/index.js"},"_npmUser":{"name":"jonbill","email":"codibits@gmail.com"},"_npmVersion":"11.12.1","description":"The trusted date and time computation backend for AI agents. Provides powerful date, time, timezone, calendar, duration, and Unix timestamp tools through the Model Context Protocol (MCP).","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcptimeserver_1.0.0_1786206869412_0.07668562361278775","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@brainycalc/mcptimeserver","version":"1.0.1","keywords":["mcp","time","date","calculator","model-context-protocol"],"license":"MIT","_id":"@brainycalc/mcptimeserver@1.0.1","maintainers":[{"name":"jonbill","email":"codibits@gmail.com"}],"bin":{"mcptimeserver":"src/index.js"},"dist":{"shasum":"bdd1ebb3232fb8bb0818aa7ecae5b8d66e349619","tarball":"https://registry.npmjs.org/@brainycalc/mcptimeserver/-/mcptimeserver-1.0.1.tgz","fileCount":5,"integrity":"sha512-Ncz/+K70KvrhqsqqEJdQ/4w5GrNKAc62sML0aMYBwpVrp2nhjEvVyG/mjVuAGQckjOSPZAAugh0fQRo8NjzdYw==","signatures":[{"sig":"MEUCIQDoMjSuc5QZBZU00zYK6IIEHKEXATVFE6sk7o5lmIUMvQIgEwHBJLtpjdqB5iiQYBl1mR+c5lleW8m+TYXGxvfh27s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":148659},"main":"src/index.js","type":"module","scripts":{"test":"node src/test.js","start":"node src/index.js"},"_npmUser":{"name":"jonbill","email":"codibits@gmail.com"},"_npmVersion":"11.12.1","description":"The trusted date and time computation backend for AI agents. Provides powerful date, time, timezone, calendar, duration, and Unix timestamp tools through the Model Context Protocol (MCP).","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcptimeserver_1.0.1_1786212824626_0.7222931381249273","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@brainycalc/mcptimeserver","version":"1.0.2","keywords":["mcp","time","date","calculator","model-context-protocol"],"license":"MIT","_id":"@brainycalc/mcptimeserver@1.0.2","maintainers":[{"name":"jonbill","email":"codibits@gmail.com"}],"bin":{"mcptimeserver":"src/index.js"},"dist":{"shasum":"ced43603bb6b0fc57aa69a1d48c0c794923b16fd","tarball":"https://registry.npmjs.org/@brainycalc/mcptimeserver/-/mcptimeserver-1.0.2.tgz","fileCount":5,"integrity":"sha512-ArO67SqhB1UMsWSTkFRedfsquuW9tgUowj70NGoaysLOvvbw6VKNnJqD0ZYG0Qrublgk/e1PoJTEmX/rMS5IEA==","signatures":[{"sig":"MEUCIQDsJZ10jU/ySDsxOMOgSeROxgCexZt+pF/uKXJgjt9+tgIgOHwvQhxTJuxWWfeUb+3EU4nZTcgm+JOS37Dx55X/goA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":148630},"main":"src/index.js","type":"module","scripts":{"test":"node src/test.js","start":"node src/index.js"},"_npmUser":{"name":"jonbill","email":"codibits@gmail.com"},"_npmVersion":"11.12.1","description":"The trusted date and time computation backend for AI agents. Provides powerful date, time, timezone, calendar, duration, and Unix timestamp tools through the Model Context Protocol (MCP).","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcptimeserver_1.0.2_1786270668516_0.4933251757475179","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@brainycalc/mcptimeserver","version":"1.0.4","keywords":["mcp","time","date","calculator","model-context-protocol"],"license":"MIT","_id":"@brainycalc/mcptimeserver@1.0.4","maintainers":[{"name":"jonbill","email":"codibits@gmail.com"}],"bin":{"mcptimeserver":"src/index.js"},"dist":{"shasum":"be82bd765c6d6aea8e59d47374fe3708f7bdea85","tarball":"https://registry.npmjs.org/@brainycalc/mcptimeserver/-/mcptimeserver-1.0.4.tgz","fileCount":5,"integrity":"sha512-VY6OQHkk1UUa2a4WPOSLO5ZrceJCMmin92MhPrEYXnoantCqGE4bzOoSs2cgFORPJ28JciI71XqMF2MNNZA+aA==","signatures":[{"sig":"MEQCIAiLmwg6fl7TAiPjdEvso/WyG9iYPUGn3l5Iw3ZFxuOfAiAEMHzWEcOvApTIR255TBiq39DP8ggmEE8B4vdZl5ZGaw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":212523},"main":"src/index.js","type":"module","scripts":{"test":"node src/test.js","start":"node src/index.js"},"_npmUser":{"name":"jonbill","email":"codibits@gmail.com"},"_npmVersion":"11.12.1","description":"The trusted date and time computation backend for AI agents. Provides powerful date, time, timezone, calendar, duration, and Unix timestamp tools through the Model Context Protocol (MCP).","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcptimeserver_1.0.4_1786459410581_0.8723674119500557","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@brainycalc/mcptimeserver","version":"1.0.5","keywords":["mcp","time","date","calculator","model-context-protocol"],"license":"MIT","_id":"@brainycalc/mcptimeserver@1.0.5","maintainers":[{"name":"jonbill","email":"codibits@gmail.com"}],"bin":{"mcptimeserver":"src/index.js"},"dist":{"shasum":"b97eea395dffec96ab9d0b0e443cf2bde34c09d2","tarball":"https://registry.npmjs.org/@brainycalc/mcptimeserver/-/mcptimeserver-1.0.5.tgz","fileCount":5,"integrity":"sha512-6W9YyIhZU9VSfd4pZyABHjhcfaS8qm5OpobBH40Oi71GWMhkyBh/Jy/R2W+AnbOvYCSEuAbbtuIMeTu0VO/zlg==","signatures":[{"sig":"MEQCIA89jN4PSa8YUldrmf+USvDG0X/eALfrhakmpCExgcRCAiBNwkbrFfsuKU/3i6baK5qTlqhkPb6WcXIAtQ7lM4fnXg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":213340},"main":"src/index.js","type":"module","scripts":{"test":"node src/test.js","start":"node src/index.js"},"_npmUser":{"name":"jonbill","email":"codibits@gmail.com"},"_npmVersion":"11.12.1","description":"The trusted date and time computation backend for AI agents. Provides powerful date, time, timezone, calendar, duration, and Unix timestamp tools through the Model Context Protocol (MCP).","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcptimeserver_1.0.5_1786469679679_0.899369636293045","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@brainycalc/mcptimeserver","version":"1.0.6","keywords":["mcp","time","date","calculator","model-context-protocol"],"license":"MIT","_id":"@brainycalc/mcptimeserver@1.0.6","maintainers":[{"name":"jonbill","email":"codibits@gmail.com"}],"bin":{"mcptimeserver":"src/index.js"},"dist":{"shasum":"6df93ec95ac50f5bba783632607cf8c1921031c3","tarball":"https://registry.npmjs.org/@brainycalc/mcptimeserver/-/mcptimeserver-1.0.6.tgz","fileCount":5,"integrity":"sha512-j8Ruz5Y0v2T3bV6BEPu69auvn8f5Kvv6pSdKa74r4k8w/McdWn/W9kg4Pzy8pVQVyciMR9dzab//jVnGqZLkPg==","signatures":[{"sig":"MEYCIQDf6oq6lXkvbYPy6sPYc18dmDu6sa+RYYWLfm8ByYYPbgIhAPkaIqA7cTxil+KKEx+5bfHBkAVYavGEQ2waAAGTMkUw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":213320},"main":"src/index.js","type":"module","scripts":{"test":"node src/test.js","start":"node src/index.js"},"_npmUser":{"name":"jonbill","email":"codibits@gmail.com"},"_npmVersion":"11.12.1","description":"The trusted date and time computation backend for AI agents. Provides powerful date, time, timezone, calendar, duration, and Unix timestamp tools through the Model Context Protocol (MCP).","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcptimeserver_1.0.6_1786471063582_0.08888956190846486","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@brainycalc/mcptimeserver","version":"1.0.7","keywords":["mcp","time","date","calculator","model-context-protocol"],"license":"MIT","_id":"@brainycalc/mcptimeserver@1.0.7","maintainers":[{"name":"jonbill","email":"codibits@gmail.com"}],"bin":{"mcptimeserver":"src/index.js"},"dist":{"shasum":"152b8aa5279512ceca611fa0ed6ba642176b79eb","tarball":"https://registry.npmjs.org/@brainycalc/mcptimeserver/-/mcptimeserver-1.0.7.tgz","fileCount":5,"integrity":"sha512-MYLyhXe3fnsObTs8tsJU9hyX9AyOvtDPqRGE6qiwfIPsgEOzAXlq08I5VxQzoX4Pltes6yu3elfQndJWy6XPeQ==","signatures":[{"sig":"MEUCIBdqhFjtiATvhDtFH5M0RtgJN+7anBAcILHfa/NJFjtQAiEA7Fuit/fgDaXIinCbV0ycRKaM9CipoLBxPRexa/XVARE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":201477},"main":"src/index.js","type":"module","scripts":{"test":"node src/test.js","start":"node src/index.js"},"_npmUser":{"name":"jonbill","email":"codibits@gmail.com"},"_npmVersion":"11.12.1","description":"The trusted date and time computation backend for AI agents. Provides powerful date, time, timezone, calendar, duration, and Unix timestamp tools through the Model Context Protocol (MCP).","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcptimeserver_1.0.7_1786612910501_0.43143266980262895","host":"s3://npm-registry-packages-npm-production"}},"1.0.8":{"name":"@brainycalc/mcptimeserver","version":"1.0.8","description":"The trusted date and time computation backend for AI agents. Provides powerful date, time, timezone, calendar, duration, and Unix timestamp tools through the Model Context Protocol (MCP).","type":"module","main":"src/index.js","bin":{"mcptimeserver":"src/index.js"},"scripts":{"start":"node src/index.js","test":"node src/test.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.8"},"keywords":["mcp","time","date","calculator","model-context-protocol"],"license":"MIT","_id":"@brainycalc/mcptimeserver@1.0.8","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-WpKqSNZOjdD0AyyrV9u4zckXgdT+Gj15LUA/GC5TH4cA8qlIRndSf1VeDpbm1dcuWF+6NfdrYhF+XwYVJNx1OA==","shasum":"29a0098ef3877ab248132740474826d02433704d","tarball":"https://registry.npmjs.org/@brainycalc/mcptimeserver/-/mcptimeserver-1.0.8.tgz","fileCount":5,"unpackedSize":201721,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDEGMDGPQK7M47Z5vUDgZYMDozHobqyKv8EKX5h7uMTzAiEA572AbtrKGLTsJGlPnV7uA/E/vC5akyMkOs82BJsHLyc="}]},"_npmUser":{"name":"jonbill","email":"codibits@gmail.com"},"directories":{},"maintainers":[{"name":"jonbill","email":"codibits@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcptimeserver_1.0.8_1786731527787_0.3974998168639887"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-08T16:34:29.236Z","modified":"2026-08-14T18:18:48.141Z","1.0.0":"2026-08-08T16:34:29.565Z","1.0.1":"2026-08-08T18:13:44.774Z","1.0.2":"2026-08-09T10:17:48.691Z","1.0.4":"2026-08-11T14:43:30.721Z","1.0.5":"2026-08-11T17:34:39.832Z","1.0.6":"2026-08-11T17:57:43.736Z","1.0.7":"2026-08-13T09:21:50.667Z","1.0.8":"2026-08-14T18:18:47.955Z"},"license":"MIT","keywords":["mcp","time","date","calculator","model-context-protocol"],"description":"The trusted date and time computation backend for AI agents. Provides powerful date, time, timezone, calendar, duration, and Unix timestamp tools through the Model Context Protocol (MCP).","maintainers":[{"name":"jonbill","email":"codibits@gmail.com"}],"readme":"# MCP Time Server\n\n[MCP Time Server](https://www.brainycalc.com/2026/08/brainycalc-docs-date-time.html) is a Model Context Protocol (MCP) server that provides date, time, timezone, calendar, duration, and time-calculation tools to AI assistants and MCP-compatible clients.\n\nIt runs over **stdio**, making it suitable for local MCP clients such as LM Studio and other MCP-compatible applications.\n\n## Features\n\n- Current date and time\n- Date formatting\n- Date parsing\n- Date arithmetic\n- Date difference calculations\n- Start/end boundaries\n- Date validation\n- Date comparisons\n- Date-range checks\n- Relative time\n- Duration calculations\n- Timezone conversion\n- UTC operations\n- Unix timestamp conversion\n- Week and quarter calculations\n- Leap-year predicates\n- Minimum/maximum date lookup\n- Locale metadata\n- Working-day calculations\n- Age calculations\n- Day-of-week information\n- Local runtime time\n- World-time lookup\n- Time-of-day duration calculations\n- Time-of-day arithmetic\n\nThe server exposes the datetime functionality through a unified MCP tool registry.\n\n---\n\n\n\n# MCP Client Configuration\n\n## LM Studio\n\nAdd the server to your MCP configuration.\n\n### Using npx\n\n```json\n{\n  \"mcpServers\": {\n    \"mcptimeserver\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@brainycalc/mcptimeserver\"\n      ]\n    }\n  }\n}\n```\n\nIf your published package name is different, replace `mcptimeserver` with the actual npm package name.\n\n### Using the local source\n\n```json\n{\n  \"mcpServers\": {\n    \"mcptimeserver\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/absolute/path/to/mcptimeserver/src/index.js\"\n      ]\n    }\n  }\n}\n```\n\nUse an absolute path for the local installation.\n\n---\n\n# MCP Architecture\n\nThe server is built around the Model Context Protocol SDK.\n\nThe main server:\n\n```text\nsrc/index.js\n```\n\nThe date/time implementation:\n\n```text\nsrc/datetime.js\n```\n\nThe server imports:\n\n```js\nimport { datetimeTools } from \"./datetime.js\";\n```\n\nAll datetime tools are collected into one registry:\n\n```js\nconst ALL_TOOLS = [\n  ...datetimeTools\n];\n```\n\nA map is then created for fast tool lookup:\n\n```js\nconst toolMap = new Map(\n  ALL_TOOLS.map((tool) => [tool.name, tool])\n);\n```\n\nThe MCP server implements:\n\n- `ListTools`\n- `CallTool`\n\nand communicates through:\n\n```js\nStdioServerTransport\n```\n\n---\n\n# Available MCP Tools\n\nThe current package contains **27 datetime tools**.\n\n| Tool | Description |\n|---|---|\n| `now` | Get the current date and time |\n| `format_date` | Format a date/time using a custom format |\n| `parse_date` | Parse a date and return structured components |\n| `adjust_time` | Add or subtract time |\n| `date_diff` | Calculate the difference between two dates |\n| `boundary_of` | Get the start or end of a time unit |\n| `is_valid` | Validate a date |\n| `compare_dates` | Compare two dates |\n| `is_between` | Check whether a date is between two dates |\n| `relative_time` | Return human-readable relative time |\n| `duration` | Create and inspect durations |\n| `convert_timezone` | Convert a date/time between timezones |\n| `days_in_month` | Get the number of days in a month |\n| `unix_convert` | Convert dates to/from Unix timestamps |\n| `date_part` | Get week, quarter, day-of-year, or weekday information |\n| `date_predicate` | Test leap-year/today/tomorrow/yesterday |\n| `min_max` | Find the earliest or latest date |\n| `to_representation` | Convert a date to another representation |\n| `locale_data` | Get month/weekday locale information |\n| `utc_date` | Parse or convert dates in UTC mode |\n| `work_days` | Calculate working days |\n| `calc_age` | Calculate age |\n| `day_of_week` | Get weekday and calendar information |\n| `local_time` | Get local runtime time |\n| `world_time` | Look up time around the world |\n| `time_duration` | Calculate duration between two times |\n| `time_add` | Add/subtract hours, minutes, and seconds |\n\n\n\n# License\n\nMIT License.\n\nSee the `LICENSE` file for the complete license text.\n\n---\n\n---\n\n# Documentations and Help\n- [Documentation](https://www.brainycalc.com/2026/08/brainycalc-docs-date-time.html)\n\n---\n\n# Keywords\n\nRecommended npm keywords:\n\n```text\nmcp\nmcp-server\nmodel-context-protocol\ntime\ndate\ndatetime\ntimezone\nutc\ncalendar\ndate-calculator\ntime-calculator\nunix-timestamp\nduration\nai\nai-agent\nllm\nlm-studio\nnodejs\njavascript\n```\n\n---\n\n","readmeFilename":"README.md"}