@chronary/mcp 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to `@chronary/mcp` will be documented in this file starting with the soft-launch release.
+
+## 0.1.2 — 2026-05-20
+
+- Initial public release as **`@chronary/mcp`** on npm (scoped, org-owned).
+- Renamed from the unscoped `chronary-mcp` (briefly published 2026-05-20 then unpublished within the 72-hour window — never publicly consumed). The rename brings the package in line with the `@chronary/sdk`, `@chronary/toolkit`, and `@chronary/schemas` siblings and makes it discoverable on https://www.npmjs.com/org/chronary.
+- The CLI binary name remains **`chronary-mcp`** — only the npm install path changed:
+  - Old: `npx -y chronary-mcp`
+  - New: `npx -y @chronary/mcp`
+- Add `CONTRIBUTING.md` to the public mirror documenting that this repo is generated from a private monorepo; PRs are welcome as proof-of-concept but can't be merged directly. No behavioral change.

package/LICENSE

@@ -0,0 +1,189 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Chronary
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,259 @@
+# @chronary/mcp
+
+MCP server for [Chronary](https://chronary.ai) — calendar tools for AI assistants.
+
+Drops 23 calendar tools (list/create/update/delete events, check availability, manage webhooks, iCal subscriptions, usage) into any MCP-compatible client: Claude Desktop, Cursor, VS Code Copilot, Claude Code, Windsurf.
+
+## Prerequisites
+
+1. A Chronary account — sign up at [chronary.ai](https://chronary.ai).
+2. An API key from the console (starts with `chr_sk_`).
+3. Node.js ≥ 18 on the machine where the MCP client runs.
+
+## Client configurations
+
+All examples use `npx -y @chronary/mcp`, which downloads and runs the latest version on demand. No install step required.
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+**macOS / Linux:**
+
+```json
+{
+  "mcpServers": {
+    "chronary": {
+      "command": "npx",
+      "args": ["-y", "@chronary/mcp"],
+      "env": {
+        "CHRONARY_API_KEY": "chr_sk_..."
+      }
+    }
+  }
+}
+```
+
+**Windows** (uses `cmd /c` because `spawn` can't resolve `npx.cmd` directly):
+
+```json
+{
+  "mcpServers": {
+    "chronary": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@chronary/mcp"],
+      "env": {
+        "CHRONARY_API_KEY": "chr_sk_..."
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop after saving.
+
+### Cursor
+
+Edit `.cursor/mcp.json` (project-level) or `~/.cursor/mcp.json` (user-level):
+
+**macOS / Linux:**
+
+```json
+{
+  "mcpServers": {
+    "chronary": {
+      "command": "npx",
+      "args": ["-y", "@chronary/mcp"],
+      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
+    }
+  }
+}
+```
+
+**Windows:**
+
+```json
+{
+  "mcpServers": {
+    "chronary": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@chronary/mcp"],
+      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
+    }
+  }
+}
+```
+
+### VS Code Copilot
+
+Edit `.vscode/mcp.json` (workspace) or run the **MCP: Open User Configuration** command for a user-level config. VS Code uses a different top-level key (`servers`) and requires an explicit `type`:
+
+**macOS / Linux:**
+
+```json
+{
+  "servers": {
+    "chronary": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@chronary/mcp"],
+      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
+    }
+  }
+}
+```
+
+**Windows:**
+
+```json
+{
+  "servers": {
+    "chronary": {
+      "type": "stdio",
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@chronary/mcp"],
+      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Edit `.mcp.json` at the project root, or `~/.claude.json` for user-level:
+
+**macOS / Linux:**
+
+```json
+{
+  "mcpServers": {
+    "chronary": {
+      "command": "npx",
+      "args": ["-y", "@chronary/mcp"],
+      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
+    }
+  }
+}
+```
+
+**Windows:**
+
+```json
+{
+  "mcpServers": {
+    "chronary": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@chronary/mcp"],
+      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Edit `~/.codeium/windsurf/mcp_config.json` (`%USERPROFILE%\.codeium\windsurf\mcp_config.json` on Windows):
+
+**macOS / Linux:**
+
+```json
+{
+  "mcpServers": {
+    "chronary": {
+      "command": "npx",
+      "args": ["-y", "@chronary/mcp"],
+      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
+    }
+  }
+}
+```
+
+**Windows:**
+
+```json
+{
+  "mcpServers": {
+    "chronary": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@chronary/mcp"],
+      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
+    }
+  }
+}
+```
+
+> **Windsurf limit:** Cascade enforces a hard cap of 100 total tools across all MCP servers and 20 tool calls per prompt. Chronary exposes 23; consider `--tools` filtering if you stack multiple servers.
+
+## Reducing context with `--tools`
+
+Exposing all 23 tools uses ~3–5k LLM tokens per request. For focused workflows, whitelist only what you need:
+
+```json
+{
+  "mcpServers": {
+    "chronary": {
+      "command": "npx",
+      "args": [
+        "-y", "@chronary/mcp",
+        "--tools", "list_events,check_availability,create_event"
+      ],
+      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
+    }
+  }
+}
+```
+
+## Pointing at a non-production API
+
+For self-hosted Chronary instances or development against a local API:
+
+```json
+{
+  "args": ["-y", "@chronary/mcp", "--base-url", "http://localhost:8787"]
+}
+```
+
+## Tools exposed
+
+| Tool | Read-only | Destructive |
+|------|-----------|-------------|
+| `list_calendars`, `get_calendar` | ✓ | |
+| `create_calendar`, `update_calendar` | | |
+| `delete_calendar` | | ✓ |
+| `list_events`, `get_event` | ✓ | |
+| `create_event`, `update_event` | | |
+| `delete_event` | | ✓ |
+| `check_availability` | ✓ | |
+| `list_webhooks`, `get_webhook` | ✓ | |
+| `create_webhook`, `update_webhook` | | |
+| `delete_webhook` | | ✓ |
+| `list_ical_subscriptions`, `get_ical_subscription` | ✓ | |
+| `create_ical_subscription`, `update_ical_subscription`, `sync_ical_subscription` | | |
+| `delete_ical_subscription` | | ✓ |
+| `get_usage` | ✓ | |
+
+Tool annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`) are surfaced to MCP clients so hosts can decide whether to require user confirmation.
+
+## Troubleshooting
+
+**"spawn npx ENOENT" on Windows** — use the `cmd /c npx ...` form shown above.
+
+**"CHRONARY_API_KEY is required"** — the env block must be nested under the server entry, not at the top of the config file.
+
+**Tools aren't showing up** — restart the MCP client after editing the config. Most clients only read the config on startup.
+
+**Verify the binary runs locally:**
+
+```sh
+CHRONARY_API_KEY=test npx -y @chronary/mcp --help
+```
+
+## Links
+
+- [Chronary docs](https://docs.chronary.ai)
+- [MCP spec](https://modelcontextprotocol.io)
+- [Report an issue](https://github.com/Chronary/chronary/issues)
+
+## License
+
+Apache-2.0

package/dist/args.js

@@ -0,0 +1,76 @@
+import { TOOL_NAMES } from '@chronary/toolkit';
+const VALID_TOOL_NAMES = new Set(TOOL_NAMES);
+/**
+ * Parse CLI arguments. Pure function — no side effects, no process.exit.
+ * Caller decides what to do with errors.
+ */
+export function parseArgs(argv) {
+    const result = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--version':
+            case '-v':
+                result.version = true;
+                break;
+            case '--help':
+            case '-h':
+                result.help = true;
+                break;
+            case '--tools': {
+                const value = argv[i + 1];
+                if (!value || value.startsWith('-')) {
+                    return { ok: false, error: '--tools requires a comma-separated list of tool names' };
+                }
+                const requested = value.split(',').map((t) => t.trim()).filter(Boolean);
+                if (requested.length === 0) {
+                    return { ok: false, error: '--tools list cannot be empty' };
+                }
+                const invalid = requested.filter((t) => !VALID_TOOL_NAMES.has(t));
+                if (invalid.length > 0) {
+                    return { ok: false, error: `unknown tool name(s): ${invalid.join(', ')}` };
+                }
+                result.tools = requested;
+                i++;
+                break;
+            }
+            case '--base-url': {
+                const value = argv[i + 1];
+                if (!value || value.startsWith('-')) {
+                    return { ok: false, error: '--base-url requires a URL' };
+                }
+                try {
+                    new URL(value);
+                }
+                catch {
+                    return { ok: false, error: `--base-url is not a valid URL: ${value}` };
+                }
+                result.baseUrl = value;
+                i++;
+                break;
+            }
+            default:
+                return { ok: false, error: `unknown argument: ${arg}` };
+        }
+    }
+    return { ok: true, value: result };
+}
+export const HELP_TEXT = `chronary-mcp — MCP server for Chronary
+
+Usage:
+  chronary-mcp [options]
+
+Environment:
+  CHRONARY_API_KEY   Required. Your Chronary API key (chr_sk_...).
+
+Options:
+  --tools <names>    Comma-separated list of tool names to expose (default: all 23 tools).
+                     Example: --tools list_events,check_availability,create_event
+  --base-url <url>   Override the API base URL (default: https://api.chronary.ai).
+  --version, -v      Print version and exit.
+  --help, -h         Print this help and exit.
+
+Docs:
+  https://docs.chronary.ai
+`;
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+// MCP uses stdout exclusively for JSON-RPC — redirect any accidental console.log to stderr
+// so library/transitive writes don't corrupt the transport stream.
+console.log = console.error;
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ChronaryToolkit } from '@chronary/toolkit/mcp';
+import { parseArgs, HELP_TEXT } from './args.js';
+import { VERSION } from './version.js';
+const parsed = parseArgs(process.argv.slice(2));
+if (!parsed.ok) {
+    console.error(`Error: ${parsed.error}`);
+    console.error(`Run 'chronary-mcp --help' for usage.`);
+    process.exit(2);
+}
+if (parsed.value.help) {
+    console.error(HELP_TEXT);
+    process.exit(0);
+}
+if (parsed.value.version) {
+    console.error(VERSION);
+    process.exit(0);
+}
+const apiKey = process.env.CHRONARY_API_KEY;
+if (!apiKey) {
+    console.error('Error: CHRONARY_API_KEY environment variable is required.');
+    console.error(`Run 'chronary-mcp --help' for usage.`);
+    process.exit(1);
+}
+const toolkit = new ChronaryToolkit({
+    apiKey,
+    baseUrl: parsed.value.baseUrl,
+    tools: parsed.value.tools,
+    // Identify MCP traffic to the API for analytics. UA stays as `chronary-ts/...`
+    // from the underlying SDK; this header surfaces the wrapper identity.
+    extraHeaders: { 'X-Chronary-Client': `chronary-mcp/${VERSION}` },
+});
+const server = new McpServer({ name: 'chronary-mcp', version: VERSION });
+toolkit.registerAll(server);
+const transport = new StdioServerTransport();
+const shutdown = async (signal) => {
+    console.error(`\nReceived ${signal}, shutting down chronary-mcp...`);
+    try {
+        await server.close();
+    }
+    catch (err) {
+        console.error('Error during shutdown:', err);
+    }
+    process.exit(0);
+};
+process.on('SIGINT', () => { void shutdown('SIGINT'); });
+process.on('SIGTERM', () => { void shutdown('SIGTERM'); });
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = '0.1.2';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@chronary/mcp",
+  "version": "0.1.2",
+  "description": "MCP server for Chronary — calendar tools for AI assistants (Claude Desktop, Cursor, VS Code, Windsurf)",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "chronary-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "chronary",
+    "calendar",
+    "ai",
+    "ai-agent",
+    "claude",
+    "cursor",
+    "vscode"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Chronary/chronary-mcp"
+  },
+  "homepage": "https://docs.chronary.ai",
+  "bugs": {
+    "url": "https://github.com/Chronary/chronary-mcp/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23",
+    "@chronary/sdk": "0.1.4",
+    "@chronary/toolkit": "0.1.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}