@modootoday/pmcp 0.13.0 → 0.14.0

package/plugins/firebase-admin-14/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/plugins/firebase-admin-14/NOTICE

@@ -0,0 +1,51 @@
+pmcp
+
+Copyright (c) 2026 modootoday. All rights reserved.
+
+Licensor: modootoday
+Licensed under the Elastic License 2.0; see LICENSE.
+
+The licensor is modootoday, the company, not any individual contributor. This
+file names the licensor because the Elastic License 2.0 defines that term rather
+than carrying a copyright line of its own; LICENSE is kept unmodified.
+
+What the licence permits, in short, without replacing the terms in LICENSE:
+
+  - Using this software inside your own company, on any scale.
+  - Embedding it in a product you sell, and modifying or forking it.
+  - Redistributing it, with these notices intact.
+  - Running it locally as an MCP server, which is what it is for. A host
+    process spawning it on your own machine is use, not a hosted service.
+
+What it does not permit:
+
+  - Offering this software to third parties as a hosted or managed service.
+    A remotely hosted MCP endpoint serving other people is the case this
+    forbids.
+  - Circumventing licence key functionality.
+  - Removing or obscuring these notices.
+
+The Elastic License 2.0 is source-available, not an OSI-approved open source
+licence. It grants a patent licence and ends that licence if you assert a patent
+claim against the software; see the Patents section of LICENSE.
+
+LICENSE governs. Where this summary and LICENSE differ, LICENSE is what applies.
+
+---
+
+This software depends on the following packages, which are distributed under
+their own terms and are not covered by the licence above.
+
+  @modelcontextprotocol/server   MIT   Copyright (c) Anthropic, PBC
+  @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
+  zod                            MIT   Copyright (c) Colin McDonnell
+  semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
+
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
+
+@huggingface/transformers is an optional peer dependency. It is never
+distributed with this package; a user who wants semantic ranking installs it
+themselves, under its own Apache-2.0 terms.

package/plugins/firebase-admin-14/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "firebase-admin-14", "version": "14.0.0" }

package/plugins/firebase-admin-14/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "firebase-admin-14",
+  "version": "14.0.0",
+  "description": "Practical firebase-admin ^14.0.0 guidance for Node.js 22+ server applications, using v14 modular imports and avoiding removed legacy APIs.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/firebase-admin-14/skills/firebase-admin/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: firebase-admin
+description: Practical firebase-admin ^14.0.0 guidance for Node.js 22+ server applications, using v14 modular imports and avoiding removed legacy APIs.
+---
+
+Verified against firebase-admin@14.3.0 on 2026-09-08. 4 of 4 examples executed.
+
+# firebase-admin ^14.0.0
+
+Use this skill for `firebase-admin` version `^14.0.0` in a Node.js 22+ server application. Firebase Admin SDK v14 requires Node.js 22 or newer; Node.js 18 and 20 are no longer supported.
+
+## Use the modular API
+
+Import each service from its documented module:
+
+```ts
+import { initializeApp } from 'firebase-admin/app';
+import { getAuth } from 'firebase-admin/auth';
+import { getFirestore } from 'firebase-admin/firestore';
+import { getMessaging } from 'firebase-admin/messaging';
+```
+
+Do not use the older namespaced shape:
+
+```ts
+import * as admin from 'firebase-admin';
+admin.initializeApp();
+admin.auth();
+```
+
+The v13 namespaced API was retained temporarily but was documented for removal. v14 removes legacy namespace support. The deprecated Instance ID API was also removed; code using `admin.instanceId()` must be migrated to the supported Installations APIs.
+
+## Initialize and retrieve apps
+
+Import app functions from `firebase-admin/app`:
+
+- `initializeApp(options?, appName?)` creates an app.
+- `getApp(appName?)` retrieves an existing app.
+- `getApps()` returns all initialized apps.
+
+The default app has no name argument. A named app must be retrieved with the same name used during initialization.
+
+In Google environments, default credentials are looked up automatically. `FIREBASE_CONFIG` may provide configuration for Realtime Database, Cloud Storage, or Cloud Functions. The SDK is intended for a server application with Firebase credentials and project setup.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { getApp, getApps, initializeApp } from 'firebase-admin/app';
+
+const app = initializeApp({ projectId: 'example-project' }, 'example-app');
+assert.equal(getApp('example-app'), app);
+assert.equal(getApps().includes(app), true);
+assert.equal(app.name, 'example-app');
+```
+
+The example uses a local project ID only to exercise app initialization. Production code should configure appropriate credentials and project settings.
+
+## Authentication
+
+Use `getAuth(app?)` from `firebase-admin/auth`. Omitting the argument uses the default app; passing an app binds the Auth instance to that app.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { initializeApp } from 'firebase-admin/app';
+import { getAuth } from 'firebase-admin/auth';
+
+const app = initializeApp({ projectId: 'auth-example' }, 'auth-app');
+const auth = getAuth(app);
+
+assert.equal(typeof auth, 'object');
+assert.equal(getAuth(app), auth);
+```
+
+This constructs the service without making a user or token request. User and token operations require Firebase credentials and a reachable Firebase service.
+
+## Cloud Firestore
+
+Use `getFirestore` or `initializeFirestore` from `firebase-admin/firestore`:
+
+- `getFirestore()` gets the default database for the default app.
+- `getFirestore(app)` gets the default database for a specific app.
+- `getFirestore(databaseId)` selects a named database.
+- `getFirestore(app, databaseId)` selects a named database for an app.
+- `initializeFirestore(app, settings?)` initializes Firestore with settings such as `{ preferRest: true }`.
+
+The named-database overloads are documented as Public Preview.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { initializeApp } from 'firebase-admin/app';
+import { getFirestore, initializeFirestore } from 'firebase-admin/firestore';
+
+const app = initializeApp({ projectId: 'firestore-example' }, 'firestore-app');
+const firestore = getFirestore(app);
+const restFirestore = initializeFirestore(
+  initializeApp({ projectId: 'rest-example' }, 'rest-app'),
+  { preferRest: true },
+);
+
+assert.equal(typeof firestore, 'object');
+assert.equal(typeof restFirestore, 'object');
+assert.equal(getFirestore(app), firestore);
+```
+
+The example does not read or write data, so it does not need network access. Firestore operations require a configured project and credentials.
+
+## Cloud Messaging
+
+Use `getMessaging(app?)` from `firebase-admin/messaging`. A message contains the base message fields and exactly one target: `fid`, `token` (deprecated), `topic`, or `condition`.
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { initializeApp } from 'firebase-admin/app';
+import { getMessaging } from 'firebase-admin/messaging';
+
+const app = initializeApp({ projectId: 'messaging-example' }, 'messaging-app');
+const messaging = getMessaging(app);
+
+assert.equal(typeof messaging, 'object');
+assert.equal(getMessaging(app), messaging);
+```
+
+Do not copy older Cloud Messaging message types: v14 removed legacy message types. Later 14.x releases also deprecate additional Messaging types, so check the exact installed 14.x release before depending on a type.
+
+## Other documented modules
+
+The documented module entry points also include:
+
+- `firebase-admin/app-check`
+- `firebase-admin/data-connect`
+- `firebase-admin/database`
+- `firebase-admin/eventarc`
+- `firebase-admin/extensions`
+- `firebase-admin/functions`
+- `firebase-admin/installations`
+- `firebase-admin/machine-learning`
+- `firebase-admin/phone-number-verification`
+- `firebase-admin/project-management`
+- `firebase-admin/remote-config`
+- `firebase-admin/security-rules`
+- `firebase-admin/storage`
+
+Use the corresponding module entry point rather than assuming a top-level namespace API. The reviewed material does not provide exact signatures or credential-free standalone behavior for these modules.
+
+## Version and runtime cautions
+
+- v14.0.0 requires Node.js 22 or newer.
+- `^14.0.0` permits later 14.x releases. The release notes document additional changes in 14.1.0 and 14.2.0, including more Messaging deprecations and a Cloud Functions `taskQueue()` scoping change.
+- SDK-wide error handling was revamped in v14.
+- Deprecated `url.parse()` usage was replaced by Node's built-in `URL`.
+- The SDK is for server applications, not browser or unprivileged client code.
+- Service calls generally need Firebase credentials, project configuration, and network access. The examples above only exercise local initialization and service construction.
+
+## Not covered
+
+This skill does not cover service-operation signatures, credential-file setup, emulator configuration, Realtime Database, Storage, Cloud Functions, or the detailed APIs of the other documented modules. It also does not specify the exact error classes or error-handling migration rules introduced in v14, nor the precise later-14.x `taskQueue()` or Messaging changes.

package/plugins/get-uri-8/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "get-uri-8",
+  "version": "8.0.0",
+  "description": "Use get-uri 8.x to obtain readable streams from data, file, FTP, HTTP, and HTTPS URIs, or to validate supported protocols.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/get-uri-8/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/plugins/get-uri-8/NOTICE

@@ -0,0 +1,51 @@
+pmcp
+
+Copyright (c) 2026 modootoday. All rights reserved.
+
+Licensor: modootoday
+Licensed under the Elastic License 2.0; see LICENSE.
+
+The licensor is modootoday, the company, not any individual contributor. This
+file names the licensor because the Elastic License 2.0 defines that term rather
+than carrying a copyright line of its own; LICENSE is kept unmodified.
+
+What the licence permits, in short, without replacing the terms in LICENSE:
+
+  - Using this software inside your own company, on any scale.
+  - Embedding it in a product you sell, and modifying or forking it.
+  - Redistributing it, with these notices intact.
+  - Running it locally as an MCP server, which is what it is for. A host
+    process spawning it on your own machine is use, not a hosted service.
+
+What it does not permit:
+
+  - Offering this software to third parties as a hosted or managed service.
+    A remotely hosted MCP endpoint serving other people is the case this
+    forbids.
+  - Circumventing licence key functionality.
+  - Removing or obscuring these notices.
+
+The Elastic License 2.0 is source-available, not an OSI-approved open source
+licence. It grants a patent licence and ends that licence if you assert a patent
+claim against the software; see the Patents section of LICENSE.
+
+LICENSE governs. Where this summary and LICENSE differ, LICENSE is what applies.
+
+---
+
+This software depends on the following packages, which are distributed under
+their own terms and are not covered by the licence above.
+
+  @modelcontextprotocol/server   MIT   Copyright (c) Anthropic, PBC
+  @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
+  zod                            MIT   Copyright (c) Colin McDonnell
+  semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
+
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
+
+@huggingface/transformers is an optional peer dependency. It is never
+distributed with this package; a user who wants semantic ranking installs it
+themselves, under its own Apache-2.0 terms.

package/plugins/get-uri-8/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "get-uri-8", "version": "8.0.0" }

package/plugins/get-uri-8/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "get-uri-8",
+  "version": "8.0.0",
+  "description": "Use get-uri 8.x to obtain readable streams from data, file, FTP, HTTP, and HTTPS URIs, or to validate supported protocols.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/get-uri-8/skills/get-uri/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: get-uri
+description: Use get-uri 8.x to obtain readable streams from data, file, FTP, HTTP, and HTTPS URIs, or to validate supported protocols.
+---
+
+Verified against get-uri@8.0.1 on 2026-09-08. 4 of 4 examples executed.
+
+# get-uri 8.x
+
+## Runtime and module shape
+
+- Requires Node.js 20 or newer.
+- The package is ESM. Import named exports from `get-uri`:
+
+```ts
+import { getUri, isValidProtocol, protocols } from 'get-uri';
+```
+
+- The main API is `getUri(uri, options?)`, returning a `Promise<Readable>`.
+- Accepted URI inputs are strings and `URL` objects.
+- Supported protocols are `data`, `file`, `ftp`, `http`, and `https`.
+
+## Get a readable stream
+
+Use `getUri` when the caller needs a stream rather than a buffered value. The following uses a `data:` URI, so it requires no network or filesystem access:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { getUri } from 'get-uri';
+
+const stream = await getUri('data:text/plain,hello');
+let result = '';
+
+for await (const chunk of stream) {
+  result += chunk.toString();
+}
+
+assert.equal(result, 'hello');
+```
+
+A `URL` object is also accepted:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { getUri } from 'get-uri';
+
+const stream = await getUri(new URL('data:text/plain,from-url'));
+let result = '';
+
+for await (const chunk of stream) {
+  result += chunk.toString();
+}
+
+assert.equal(result, 'from-url');
+```
+
+For `file:` URIs, the resolved stream is an `fs.ReadStream`. HTTP and HTTPS produce streams from those protocols; FTP is also supported. Those protocols require resources outside a standalone, offline example.
+
+## Protocol helpers
+
+`isValidProtocol` is a type guard for the supported protocol names:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { isValidProtocol } from 'get-uri';
+
+assert.equal(isValidProtocol('data'), true);
+assert.equal(isValidProtocol('file'), true);
+assert.equal(isValidProtocol('ftp'), true);
+assert.equal(isValidProtocol('http'), true);
+assert.equal(isValidProtocol('https'), true);
+assert.equal(isValidProtocol('gopher'), false);
+```
+
+The `protocols` export exposes the individual protocol handlers. A handler receives a parsed `URL` and optional protocol-specific options:
+
+```ts pmcp-example
+import assert from 'node:assert/strict';
+import { protocols } from 'get-uri';
+
+const stream = await protocols.data(new URL('data:text/plain,direct'));
+let result = '';
+
+for await (const chunk of stream) {
+  result += chunk.toString();
+}
+
+assert.equal(result, 'direct');
+```
+
+The available handlers are `protocols.data`, `protocols.file`, `protocols.ftp`, `protocols.http`, and `protocols.https`.
+
+## Caching and errors
+
+Pass a previous readable stream as `cache` in the options when using a protocol that supports caching. If the destination has not changed, the operation rejects with an error whose `code` is `"ENOTMODIFIED"`.
+
+A missing resource rejects with an error whose `code` is `"ENOTFOUND"`.
+
+Other options are passed through to the underlying protocol implementation, such as `http.get()` or `ftp.connect()`.
+
+## Common version mistakes
+
+- Do not use the older CommonJS shape or assume `require()` is the documented usage. get-uri 8.x is an ESM package.
+- Do not target Node 14 or another pre-20 runtime. Version 8 raised the minimum Node.js version to 20.
+- Do not expect only HTTP and HTTPS: `data`, `file`, and `ftp` are built in as well.
+- Do not expect `getUri` to return the contents directly. Await it to obtain a `Readable` stream.
+- Do not pass an ordinary protocol string to a protocol handler: the `protocols.*` functions take a parsed `URL`; use `getUri` when starting with a URI string.
+- Do not assume an unchanged cached resource resolves normally; it rejects with `code === "ENOTMODIFIED"`.
+
+## Not covered
+
+This skill does not cover the protocol-specific option fields, HTTP authentication or headers, FTP connection configuration, filesystem behavior, stream error handling, or running the package through a CLI or test runner. The available research also does not specify the exact data-URI encoding forms beyond the standalone examples shown here.

package/plugins/google-uuid-1/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "google-uuid-1",
+  "version": "1.0.0",
+  "description": "Use the Go module github.com/google/uuid to parse UUID input, enforce canonical formatting when required, generate UUIDs with error handling and serialize identifiers. Use for application UUID boundaries; this manually loaded pilot has no npm target or automatic dependency detection.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}