@prefecthq/fastmcp-ts 1.0.0-rc.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/README.md +3 -3
  2. package/dist/cli/index.cjs +759 -99
  3. package/dist/cli/index.cjs.map +1 -1
  4. package/dist/client.d.ts +44 -11
  5. package/dist/client.js +37 -5
  6. package/dist/client.js.map +1 -1
  7. package/package.json +6 -6
package/README.md CHANGED
@@ -4,7 +4,7 @@ The TypeScript framework for building [Model Context Protocol](https://modelcont
4
4
 
5
5
  Built on version 2 of the official [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) — the scoped `@modelcontextprotocol/server` and `@modelcontextprotocol/client` packages. FastMCP handles the protocol plumbing so you can focus on what your server actually does.
6
6
 
7
- FastMCP 1.0 speaks both MCP protocol generations: the 2025 legacy era and the 2026-07-28 modern era. A server serves both at once, and a client negotiates one. Upgrading from 0.x keeps your existing code running — the client defaults to the legacy era until you opt into the modern one. The [migration guide](docs/migration.mdx) covers the upgrade path.
7
+ FastMCP 1.0 speaks both MCP protocol generations: the 2025 legacy era and the 2026-07-28 modern era. A server serves both at once, and a client negotiates one. The client negotiates automatically by default: it probes once at connect, uses the modern era when the server offers it, and falls back to legacy otherwise, so upgrading from 0.x keeps your existing code running against servers of either generation. Pass `versionNegotiation: { mode: 'legacy' }` to opt out of the probe. The [migration guide](docs/migration.mdx) covers the upgrade path.
8
8
 
9
9
  ## Installation
10
10
 
@@ -289,7 +289,7 @@ fastmcp run server.ts --transport http --port 3000
289
289
  fastmcp inspect --file server.ts
290
290
  fastmcp inspect --url http://localhost:3000
291
291
  fastmcp inspect --file server.ts --json
292
- fastmcp inspect --file server.ts --modern # negotiate the 2026-07-28 protocol era over stdio
292
+ fastmcp inspect --file server.ts --legacy # force the legacy 2025 era, no probe
293
293
  fastmcp inspect --file server.ts --pin 2026-07-28 # require that exact era
294
294
 
295
295
  # Call a tool, read a resource, or get a prompt
@@ -312,7 +312,7 @@ fastmcp install claude-desktop server.ts
312
312
  fastmcp discover
313
313
  ```
314
314
 
315
- `fastmcp inspect`, `fastmcp list`, and `fastmcp call` connect over stdio by default, when you pass `--file` or `--command`. Add `--modern` to negotiate the newer 2026-07-28 protocol era. A `--url` connection negotiates the protocol version automatically, so `--modern` is not needed for HTTP. `--pin <version>` works on every transport, including HTTP. It forces that exact protocol revision. The connection fails if the server does not offer it.
315
+ `fastmcp inspect`, `fastmcp list`, and `fastmcp call` negotiate the protocol era automatically on every transport: one probe at connect, the modern 2026-07-28 era when the server offers it, and the legacy 2025 era otherwise. Add `--legacy` to skip the probe and force the legacy era. `--pin <version>` works on every transport, including HTTP. It forces that exact protocol revision. The connection fails if the server does not offer it. `--modern` is a deprecated no-op, kept for compatibility.
316
316
 
317
317
  ---
318
318