From 3434e15a21bfb992098c2fd71380fb28213b6185 Mon Sep 17 00:00:00 2001
From: Nathan Totten <nate@zuplo.com>
Date: Sun, 10 May 2026 17:59:59 -0400
Subject: [PATCH 1/2] chore: deprecate @zuplo/mcp in favor of
 @modelcontextprotocol/sdk

Add a deprecation warning callout to the README and a `deprecated` field
in package.json pointing users to the official MCP TypeScript SDK
(@modelcontextprotocol/sdk). The official SDK now covers these use cases
and is the recommended path forward for new projects and existing users.

Note: `npm deprecate @zuplo/mcp "..."` must still be run against the
registry to surface the warning at install time.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 README.md    | 21 +++++++++------------
 package.json |  3 ++-
 2 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 59ce6ab..172f505 100644
--- a/README.md
+++ b/README.md
@@ -5,21 +5,18 @@
     <code>@zuplo/mcp</code>
   </p>
 </h1>
-  <p align="center">
-    A <code>fetch</code> API based, remote server first, TypeScript SDK for MCP.
-    <br />
-    <a href="#about">About</a>
-    ·
-    <a href="#documentation">Documentation</a>
-    ·
-    <a href="#contributing">Contributing</a>
-  </p>
-</p>
+
+> [!WARNING]
+> **This package is deprecated and is no longer maintained.**
+>
+> Please use the official Model Context Protocol TypeScript SDK instead: [`@modelcontextprotocol/sdk`](https://www.npmjs.com/package/@modelcontextprotocol/sdk) ([GitHub](https://github.com/modelcontextprotocol/typescript-sdk)).
 
 ---
 
-`@zuplo/mcp` is a stateless, remote server first MCP SDK that aims to be ["minimum common API" compliant as defined by the WinterTC](https://min-common-api.proposal.wintertc.org/).
-It uses the [`fetch` APIs](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) and is intended to work out of the box on Zuplo, Node, Deno, Workerd, etc.
+`@zuplo/mcp` was a stateless, remote server first MCP SDK that aimed to be ["minimum common API" compliant as defined by the WinterTC](https://min-common-api.proposal.wintertc.org/).
+It used the [`fetch` APIs](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) and was intended to work out of the box on Zuplo, Node, Deno, Workerd, etc.
+
+The official [`@modelcontextprotocol/sdk`](https://github.com/modelcontextprotocol/typescript-sdk) now covers these use cases and is the recommended path forward. New projects should adopt it directly, and existing users of `@zuplo/mcp` should migrate.
 
 # 📝 Documentation
 
diff --git a/package.json b/package.json
index 8e083cd..481f1a7 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,8 @@
 {
   "name": "@zuplo/mcp",
   "version": "0.1.0",
-  "description": "A fetch API based, remote server first, TypeScript SDK for MCP.",
+  "description": "DEPRECATED — please use the official @modelcontextprotocol/sdk instead.",
+  "deprecated": "@zuplo/mcp is deprecated and no longer maintained. Please migrate to the official MCP TypeScript SDK: @modelcontextprotocol/sdk (https://github.com/modelcontextprotocol/typescript-sdk).",
   "type": "module",
   "scripts": {
     "build": "tsc",

From 7fcc17eb5d296361d8420578a63bdf45de8f8bbb Mon Sep 17 00:00:00 2001
From: Nathan Totten <nate@zuplo.com>
Date: Sun, 10 May 2026 18:03:21 -0400
Subject: [PATCH 2/2] chore: remove non-standard "deprecated" field from
 package.json
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The `deprecated` field is not a standard npm package.json field and is
ignored by npm when determining whether to show install-time deprecation
warnings — those come from registry metadata set via `npm deprecate`.
Keeping it here risks misleading readers into thinking the package is
already deprecated on the registry. The README warning plus the manual
`npm deprecate` step cover this properly.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 package.json | 1 -
 1 file changed, 1 deletion(-)

diff --git a/package.json b/package.json
index 481f1a7..e10c4b4 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,6 @@
   "name": "@zuplo/mcp",
   "version": "0.1.0",
   "description": "DEPRECATED — please use the official @modelcontextprotocol/sdk instead.",
-  "deprecated": "@zuplo/mcp is deprecated and no longer maintained. Please migrate to the official MCP TypeScript SDK: @modelcontextprotocol/sdk (https://github.com/modelcontextprotocol/typescript-sdk).",
   "type": "module",
   "scripts": {
     "build": "tsc",