@modootoday/pmcp 0.13.0 → 0.14.0

package/plugins/modelcontextprotocol-sdk-1/skills/modelcontextprotocol-sdk/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: modelcontextprotocol-sdk
+description: Build and test MCP v1 tools with @modelcontextprotocol/sdk, explicit Zod schemas, structured results, real client calls, and reliable transport cleanup. Keep v2 imports and protocol behavior separate.
+compatibility: MCP TypeScript SDK 1.30.0 with Zod 3.25.76. Use a supported Node.js LTS release. The split server and client packages are a different SDK generation.
+---
+
+# MCP TypeScript SDK 1.x
+
+Use this skill when the installed dependency is `@modelcontextprotocol/sdk` 1.x.
+Inspect that dependency before selecting imports. The split
+`@modelcontextprotocol/server` and `@modelcontextprotocol/client` 2.x packages
+have different registration, schema, context and protocol contracts.
+
+## Define a tool contract before its handler
+
+Import `McpServer` from `@modelcontextprotocol/sdk/server/mcp.js` and `Client`
+from `@modelcontextprotocol/sdk/client/index.js`. Use `registerTool` rather than
+adding new calls to the deprecated variadic `tool` API.
+
+```ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod/v3";
+
+const server = new McpServer({ name: "items", version: "1.0.0" });
+server.registerTool(
+  "read-item",
+  {
+    description: "Read an item by its identifier",
+    inputSchema: z.object({ itemId: z.string().min(1) }).strict(),
+    outputSchema: z.object({ itemId: z.string(), title: z.string() }),
+    annotations: { readOnlyHint: true },
+  },
+  async ({ itemId }) => {
+    const item = { itemId, title: "Example item" };
+    return {
+      content: [{ type: "text", text: item.title }],
+      structuredContent: item,
+    };
+  },
+);
+```
+
+Use strict input only when unknown properties should be rejected. Schema
+validation runs before the handler; test missing, wrong-type and unexpected
+arguments. Tool annotations describe behavior and do not enforce permissions.
+Keep authorization and side-effect limits in the application boundary.
+
+## Separate tool failures from transport failures
+
+Expected domain failures can return `isError: true` with readable `content`.
+Inspect that flag after `client.callTool`; a resolved promise does not imply
+the operation succeeded. In 1.30.0, invalid tool inputs also produce an error
+tool result. Connection and protocol failures can still reject the call.
+
+Successful structured output must satisfy `outputSchema`. A failure result
+need not fabricate successful output fields. Avoid leaking secrets or internal
+stack traces into model-visible error content.
+
+## Test through an actual client
+
+For an in-process v1 test, import `InMemoryTransport` from
+`@modelcontextprotocol/sdk/inMemory.js`. Create a linked pair, connect the
+server first, then connect the client to the other endpoint. Call `listTools`
+and `callTool` through that client rather than invoking the handler directly.
+
+Assert the advertised schema, successful `structuredContent`, `isError` for
+invalid arguments and a domain failure, and that invalid calls never reach
+the handler. Close the client and server in `finally`, including when an
+assertion fails. Keep a deadline around the entire fixture.
+
+Paired memory transport does not test stdio process management, HTTP security,
+OAuth or a particular native host. The v1 line implements protocols through
+2025-11-25; it does not gain 2026-07-28 support by changing an import.
+For stdio, send protocol messages on stdout and diagnostics on stderr.
+
+## Sources
+
+- [Official v1 documentation and version boundary](https://ts.sdk.modelcontextprotocol.io/)
+- [V1 server guide](https://ts.sdk.modelcontextprotocol.io/server.html)
+- [V2 migration guide](https://ts.sdk.modelcontextprotocol.io/v2/migration/upgrade-to-v2.html)

package/plugins/modelcontextprotocol-server-2/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "modelcontextprotocol-server-2",
+  "version": "2.0.0",
+  "description": "Expose Standard Schema tools and verify modern protocol calls through an in-process handler.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/modelcontextprotocol-server-2/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/modelcontextprotocol-server-2/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/modelcontextprotocol-server-2/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "modelcontextprotocol-server-2", "version": "2.0.0" }

package/plugins/modelcontextprotocol-server-2/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "modelcontextprotocol-server-2",
+  "version": "2.0.0",
+  "description": "Expose Standard Schema tools and verify modern protocol calls through an in-process handler.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/modelcontextprotocol-server-2/skills/modelcontextprotocol-server/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: modelcontextprotocol-server
+description: Expose MCP tools with @modelcontextprotocol/server 2.x using Standard Schema inputs, explicit result contracts, per-request server factories, and credential-free in-process HTTP tests.
+compatibility: MCP server 2.0.0 with client 2.0.0 and Zod 4.6.5. These packages require Node.js 20 or newer; use a supported LTS release.
+---
+
+# MCP TypeScript server 2.x
+
+Use the split `@modelcontextprotocol/server` package for SDK v2. Do not rewrite
+imports from v1 and assume its callback context or wire behavior is unchanged.
+Keep server creation, transport selection and application services separate.
+
+## Register explicit Standard Schema contracts
+
+Use `McpServer` and `registerTool` with a complete schema object. Zod 4.2 or
+later supplies the Standard Schema JSON conversion expected by this SDK.
+The 2.0.0 fixture uses Zod 4.6.5. A raw field map is a deprecated compatibility
+overload, not the preferred v2 contract.
+
+```ts
+import { McpServer } from "@modelcontextprotocol/server";
+import { z } from "zod/v4";
+
+function createServer() {
+  const server = new McpServer({ name: "items", version: "1.0.0" });
+  server.registerTool(
+    "read-item",
+    {
+      description: "Read an item by its identifier",
+      inputSchema: z.object({ itemId: z.string().min(1) }).strict(),
+      outputSchema: z.object({ itemId: z.string(), title: z.string() }),
+      annotations: { readOnlyHint: true },
+    },
+    async ({ itemId }) => ({
+      content: [{ type: "text", text: "Example item" }],
+      structuredContent: { itemId, title: "Example item" },
+    }),
+  );
+  return server;
+}
+```
+
+Choose strict input deliberately; otherwise a schema can silently discard
+unknown keys. Test that rejected inputs do not execute the handler. Validate
+successful structured output and return `isError: true` for expected domain
+failures instead of fabricating successful fields.
+
+A tool without an input schema receives context as its single callback argument.
+Do not interpret that context as an empty argument object. V2 HTTP request
+headers are accessed through Web Standard `Headers`, not a v1 header record.
+Annotations are hints, not application authorization.
+
+## Keep serving and integration tests distinct
+
+`createMcpHandler(createServer)` exposes a Web Standard Fetch handler. Pass
+its `fetch` to a real `StreamableHTTPClientTransport` for in-process tests;
+there is no listening socket or provider account involved. For a modern-only
+fixture, `{ legacy: "reject" }` prevents an accidental 2025-era fallback.
+
+Assert the negotiated era/version, advertised tool schema, valid structured
+result, strict argument errors and domain errors. Close the client first and
+then the handler in nested `finally` blocks. Bound the whole process so an
+unresolved request cannot retain resources indefinitely.
+
+`InMemoryTransport.createLinkedPair()` remains useful for legacy instances,
+but it does not establish 2026-07-28 coverage. Prefer the handler's Fetch path
+when testing that protocol. A factory can create separate server instances;
+inject shared application services explicitly and avoid treating handler-local
+state as a durable session store.
+
+Deployment still needs the appropriate runtime adapter, host/origin checks,
+authorization and resource limits. An in-process test does not verify those
+controls or OAuth. For a stdio service, use the package's `/stdio` entry and
+keep diagnostic output off stdout.
+
+## Sources
+
+- [Official v2 server entry point](https://ts.sdk.modelcontextprotocol.io/v2/)
+- [In-process server testing](https://ts.sdk.modelcontextprotocol.io/v2/testing.html)
+- [V1 to v2 migration](https://ts.sdk.modelcontextprotocol.io/v2/migration/upgrade-to-v2.html)

package/plugins/msw-2/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "msw-2",
+  "version": "2.0.0",
+  "description": "Use MSW 2.x for HTTP and GraphQL request interception. Covers the v2 API, Node setup, response construction, resolver inputs, migration traps from MSW 1.x, and the browser entry point.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/msw-2/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/msw-2/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/msw-2/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "msw-2", "version": "2.0.0" }

package/plugins/msw-2/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "msw-2",
+  "version": "2.0.0",
+  "description": "Use MSW 2.x for HTTP and GraphQL request interception. Covers the v2 API, Node setup, response construction, resolver inputs, migration traps from MSW 1.x, and the browser entry point.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}