npm · #1196 most downloaded on npm

@modelcontextprotocol/sdk

1.32.0modelcontextprotocol/typescript-sdk ↗New releases in your daily digest, changelog included.

Model Context Protocol implementation for TypeScript

Last release 2 days ago
02 Oct 2026
Ships unpredictably
gaps range from 8 days to 4 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
2 years old
82 releases · first in 2024

Release timeline

82 releases since 2024

202420252026

20242026

One column per month.

Releases

1.32.02 Oct 2026
Redirects: the HTTP client transports now follow a redirect only when it stays on the same origin (same scheme, host and port; http to https on the sa
Upgrade notes

Redirects: the HTTP client transports now follow a redirect only when it stays on the same origin (same scheme, host and port; http to https on the same host is allowed). A deployment whose endpoint redirects to another host or port either configures the final URL or sets redirectPolicy: 'follow' on StreamableHTTPClientTransport or SSEClientTransport. In browsers, a redirected request fails unless that option is set.

New options, both off unless you set them: maxToolInputElements on McpServer limits the number of array elements and object members in a tool call's arguments. expectedResource on requireBearerAuth accepts only tokens issued for this server (the token's audience).

What's Changed

[v1.x] fix(client): follow redirects only within the endpoint's origin by @claude[bot] in #2902

docs: point SECURITY.md at GitHub Security Advisories (v1.x) by @claude[bot] in #2910

[v1.x] examples: close idle sessions and cap the session map by @maxisbey in #2914

[v1.x] fix(tasks): keep tasks of the in-memory task store within the session that created them by @claude[bot] in #2925

[v1.x] feat(server): add maxToolInputElements option to limit the number of elements in tool-call arguments by @claude[bot] in #2927

[v1.x] fix(server): accept tools/call and prompts/get requests that omit arguments by @raashish1601 in #2045

[v1.x] feat(auth): add expectedResource to requireBearerAuth by @claude[bot] in #2930

[v1.x] test(e2e): cover tools/call and prompts/get without arguments by @claude[bot] in #2931

chore: bump version to 1.32.0 by @claude[bot] in #2935

New Contributors

@raashish1601 made their first contribution in #2045

Full Changelog: 1.31.0...1.32.0

1.31.028 Sept 2026Deprecated

Constructing them without it is deprecated.

Upgrade notes

Stored OAuth tokens and client information now include an issuer field. Storage that rejects unknown fields needs to allow it.
Pass expectedIssuer when constructing ClientCredentialsProvider, PrivateKeyJwtProvider or StaticPrivateKeyJwtProvider. Constructing them without it is deprecated.

What's Changed

[v1.x] Bind stored OAuth credentials to the authorization server that issued them by @maxisbey in #2888
chore: bump version to 1.31.0 by @claude[bot] in #2890

Full Changelog: 1.30.1...1.31.0

Open source →

1.30.027 Jul 2026

fix(server): prioritize zod issues and format them by @mozmo15 in #1503

What's Changed

fix(server): prioritize zod issues and format them by @mozmo15 in #1503
chore(ci): switch publish to OIDC trusted publishing by @felixweinberger in #1839
Add end-to-end test suite by @felixweinberger in #2167
v1 stdio buffer limit by @KKonstantinov in #2239
fix: support Zod 3.25 method literals by @mattzcarey in #2368
Validate Content-Type by parsed media type instead of substring match (v1.x) by @felixweinberger in #2444
fix: send SSE keep-alive comment frames from Streamable HTTP server transport (v1.x) by @mattzcarey in #2538
fix(deps): widen @hono/node-server past GHSA-frvp-7c67-39w9 by @arimu1 in #2549
Fix SSE keep-alive timer lifecycle in Streamable HTTP server transport (v1.x) by @felixweinberger in #2547
chore: bump version to 1.30.0 by @felixweinberger in #2563

New Contributors

@mozmo15 made their first contribution in #1503
@arimu1 made their first contribution in #2549

Full Changelog: v1.29.0...1.30.0

Open source →

1.29.030 Mar 2026

fix: treat v1.x as primary branch for npm latest tag (backport #1577) by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pu

What's Changed

fix: treat v1.x as primary branch for npm latest tag (backport #1577) by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1749
[v1.x] fix: disallow null (infinite) requested TTL by @LucaButBoring in https://github.com/modelcontextprotocol/typescript-sdk/pull/1339
[v1.x] fix: add missing size field to ResourceSchema by @olaservo in https://github.com/modelcontextprotocol/typescript-sdk/pull/1575
Add typings exports by @tdraier in https://github.com/modelcontextprotocol/typescript-sdk/pull/1623
v1.x npm audit fix by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1780
v1.x #1623 follow up -add missing types to package.json by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1773
[v1.x backport] Allow servers / clients to advertise extensions in the capability object by @localden in https://github.com/modelcontextprotocol/typescript-sdk/pull/1811
fix(stdio): always set windowsHide on Windows, not just in Electron by @jnMetaCode in https://github.com/modelcontextprotocol/typescript-sdk/pull/1640
chore: bump version to 1.29.0 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1820

New Contributors

@tdraier made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1623
@jnMetaCode made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1640

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/v1.28.0...v1.29.0

Open source →

1.28.025 Mar 2026

feat: use scopes_supported from resource metadata by default (fixes #580) by @antogyn in https://github.com/modelcontextprotocol/typescript-sdk/pull/7

What's Changed

feat: use scopes_supported from resource metadata by default (fixes #580) by @antogyn in https://github.com/modelcontextprotocol/typescript-sdk/pull/757
[v1.x backport] Default to client_secret_basic when server omits token_endpoint_auth_methods_supported by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1611
fix: reject plain JSON Schema objects passed as inputSchema by @tiluckdave in https://github.com/modelcontextprotocol/typescript-sdk/pull/1596
fix: clear _timeoutInfo in _onclose() and scope .finally() abort controller cleanup by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1462
fix(server/auth): RFC 8252 loopback port relaxation by @poteat in https://github.com/modelcontextprotocol/typescript-sdk/pull/1738
chore: bump version to 1.28.0 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1746

New Contributors

@antogyn made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/757
@tiluckdave made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1596
@poteat made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1738

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/v1.27.1...v1.28.0

Open source →

1.27.124 Feb 2026

feat: implement auth/pre-registration conformance scenario by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1545

What's Changed

feat: implement auth/pre-registration conformance scenario by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1545
docs: add governance documentation for SEP-1730 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1547
docs: comprehensive feature documentation for SEP-1730 Tier 1 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1548
fix: prevent command injection in example URL opening (v1.x backport) by @maxisbey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1579
fix: call onerror for silently swallowed transport errors by @qing-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/1580
chore: bump version to 1.27.1 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1581

New Contributors

@qing-ant made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1580

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/v1.27.0...v1.27.1

Open source →

1.27.016 Feb 2026

feat: add conformance test infrastructure for v1.x by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1518

What's Changed

feat: add conformance test infrastructure for v1.x by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1518
feat: backport discoverOAuthServerInfo() and discovery caching to v1.x by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1533
feat: add url property to RequestInfo interface by @valentinbeggi in https://github.com/modelcontextprotocol/typescript-sdk/pull/1353
[v1.x] feat(tasks): add streaming methods for elicitation and sampling by @LucaButBoring in https://github.com/modelcontextprotocol/typescript-sdk/pull/1528
chore: bump version for v1.27.0 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1541

New Contributors

@valentinbeggi made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1353

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/v1.26.0...v1.27.0

Open source →

1.26.04 Feb 2026Security

fix(deps): resolve npm audit vulnerabilities and bump dependencies (v1.x backport) by @samuv in https://github.com/modelcontextprotocol/typescript-sdk…

Addresses "Sharing server/transport instances can leak cross-client response data" in this GHSA https://github.com/modelcontextprotocol/typescript-sdk/security/advisories/GHSA-345p-7cg4-v4c7

What's Changed

chore: bump v1.25.3 for backport fixes by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1412
fix(deps): resolve npm audit vulnerabilities and bump dependencies (v1.x backport) by @samuv in https://github.com/modelcontextprotocol/typescript-sdk/pull/1382
Fix #1430: Client Credentials providers scopes support (backported) by @NSeydoux in https://github.com/modelcontextprotocol/typescript-sdk/pull/1442
chore: bump version to 1.26.0 by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1479

New Contributors

@samuv made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1382
@NSeydoux made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1442

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/v1.25.3...v1.26.0

Open source →

1.25.015 Dec 2025

list changed handlers on client constructor by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1206

What's Changed

list changed handlers on client constructor by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1206
Role - moved from inline to reusable type by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1221
fix: use versioned npm tag for non-main branch releases by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1236
No automatic completion support unless needed - Revisited yet again by @cliffhall in https://github.com/modelcontextprotocol/typescript-sdk/pull/1237
fix: Support updating output schema by @vincent0426 in https://github.com/modelcontextprotocol/typescript-sdk/pull/1048
Remove type dependency on @cfworker/json-schema by @LucaButBoring in https://github.com/modelcontextprotocol/typescript-sdk/pull/1229
Relocate tests under /test by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1220
Fix tsconfig: remove tests by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1240
tsconfig - tests and build fix by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1243
fix a typo in examples README by @DaleSeo in https://github.com/modelcontextprotocol/typescript-sdk/pull/1246
Protocol date validation by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1247
Flaky test fix on Types.test.ts by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1244
SPEC COMPLIANCE: Remove loose/passthrough types not allowed/defined by MCP spec + Task types by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1242
Follow-up fixes for PR #1242 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1274
Update server examples and docs by @DaleSeo in https://github.com/modelcontextprotocol/typescript-sdk/pull/1285
Update TypeScript config to ES2020 to fix AJV imports by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1297
Fix Zod v4 schema description extraction by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1296
Add optional description field to Implementation schema by @calclavia in https://github.com/modelcontextprotocol/typescript-sdk/pull/1295
Add theme property to Icon schema by @DaleSeo in https://github.com/modelcontextprotocol/typescript-sdk/pull/1290
feat: fetch transport by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1209
chore: bump version for release by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1301

New Contributors

@vincent0426 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1048

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.24.3...1.25.0

Open source →

1.24.34 Dec 2025Security

chore: fix dev dependency security vulnerabilities by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1227

What's Changed

chore: fix dev dependency security vulnerabilities by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1227
chore(deps): bump express from 5.0.1 to 5.2.1 in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/modelcontextprotocol/typescript-sdk/pull/1228
fix: release HTTP connections after POST responses by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1214
fix: skip priming events and closeSSEStream for old protocol versions by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1233
chore: bump version for patch release by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1235

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.24.2...1.24.3

Open source →

1.24.02 Dec 2025

This release brings us up to speed with the latest MCP spec 2025-11-25. Take a look at the latest spec as well as the release blog post.

Summary

This release brings us up to speed with the latest MCP spec 2025-11-25. Take a look at the latest spec as well as the release blog post.

What's Changed

fix: update spec links from latest to draft by @domdomegg in https://github.com/modelcontextprotocol/typescript-sdk/pull/1171
Make sure to consume HTTP error response bodies by @GreenStage in https://github.com/modelcontextprotocol/typescript-sdk/pull/1173
docs: add GET request handling for streamableHttp stateless mode by @saharis9988 in https://github.com/modelcontextprotocol/typescript-sdk/pull/1161
SEP-1686: Tasks by @LucaButBoring in https://github.com/modelcontextprotocol/typescript-sdk/pull/1041
Fix JSON parse error on SSE events with empty data by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1184
Fix StreamableHTTPClientTransport instantiation by @yuwzho in https://github.com/modelcontextprotocol/typescript-sdk/pull/944
feat: eslint rule to prefer node protocols by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1187
fix: call tasks/result to deliver side-channel messages by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1185
Add invalid_target oauth error (rfc 8707) by @GreenStage in https://github.com/modelcontextprotocol/typescript-sdk/pull/1183
fix(client): use StreamableHTTPError instead of plain Error in send() by @yamadashy in https://github.com/modelcontextprotocol/typescript-sdk/pull/1178
coerce 'expires_in' to be a number by @adam-kuhn in https://github.com/modelcontextprotocol/typescript-sdk/pull/1111
Allow HTTP issuer URLs when MCP_DEV_MODE is enabled by @jerome3o-anthropic in https://github.com/modelcontextprotocol/typescript-sdk/pull/1189
fix: update registerTool signature for proper typed ToolCallback by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1188
SEP-1046: Client credentials flow for M2M without user interaction by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1157
adds the transitive @types/express-serve-static-core dependency as a direct devDependency by @mgyarmathy in https://github.com/modelcontextprotocol/typescript-sdk/pull/1078
Fix optional argument handling in prompts for Zod V4 by @filip-bartuska-ipf in https://github.com/modelcontextprotocol/typescript-sdk/pull/1199
fix hanging stdio servers by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1200
README refactor by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1197
[Docs] Fix typo by @koic in https://github.com/modelcontextprotocol/typescript-sdk/pull/1067
feat: add closeSSEStream callback to RequestHandlerExtra by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1166
fix: improve SSE reconnection behavior by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1191
fix: normalize headers in sse transport by @marcrasi in https://github.com/modelcontextprotocol/typescript-sdk/pull/856
feat: add closeStandaloneSSEStream for GET stream polling by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1203
fix: normalize null to undefined in ElicitResultSchema content field by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1204
Modify Origin header validation in validateRequestHeaders (streamableHttp.ts and sse.ts) to allow requests without an Origin, as they are not relevant to server DNS rebinding protection. by @jacopoc in https://github.com/modelcontextprotocol/typescript-sdk/pull/1205
fix: allow zod 4 transformations by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1213
feat: backwards-compatible createMessage overloads for SEP-1577 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1212
chore: bump version for release by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1215

New Contributors

@GreenStage made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1173
@saharis9988 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1161
@yuwzho made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/944
@yamadashy made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1178
@adam-kuhn made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1111
@mgyarmathy made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1078
@filip-bartuska-ipf made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1199
@koic made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1067
@marcrasi made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/856
@jacopoc made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1205

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.23.0...1.24.0

Open source →

1.23.025 Nov 2025Deprecated

chore: Add deprecated marker to old elicitInput overload by @nbarbettini in https://github.com/modelcontextprotocol/typescript-sdk/pull/1142

What's Changed

Migrate to vitest from jest by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1074
ci: add workflow_dispatch trigger for manual CI runs by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1114
Fix: @types/node incompatibility with vite warnings on npm install by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1121
Fix: clean up accidental spec.types.ts by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1122
fix: Pass RequestInit options to auth requests by @dsp-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/1066
SEP-1036: URL Elicitation by @nbarbettini in https://github.com/modelcontextprotocol/typescript-sdk/pull/1105
add none to test and the router. by @m-henderson in https://github.com/modelcontextprotocol/typescript-sdk/pull/1116
[auth] Adjust scope management to line up with SEP-835 by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1133
chore: add .idea/ to .gitignore by @maxisbey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1134
chore: remove unused @types/eslint__js dependency by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1128
feat: url based client metadata registration (SEP 991) by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1127
feat: zod v4 with backwards compatibility for v3.25+ by @dclark27 in https://github.com/modelcontextprotocol/typescript-sdk/pull/1040
fix: remove pnpm lock and regenerate package-lock by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1138
docs: update installation instructions for zod peer dependency by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1139
Implement SEP-1577 - Sampling With Tools by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/1101
Follow up: unify v3 and v4 zod types via describe matrix and a test helper by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1141
chore: Add deprecated marker to old elicitInput overload by @nbarbettini in https://github.com/modelcontextprotocol/typescript-sdk/pull/1142
fix: Connect error in URL elicitation example by @nbarbettini in https://github.com/modelcontextprotocol/typescript-sdk/pull/1136
Support upscoping on insufficient_scope 403 by @Nayana-Parameswarappa in https://github.com/modelcontextprotocol/typescript-sdk/pull/1115
Support beta releases by publishing with --tag beta by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1146
Bump version to 1.23.0-beta.0 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1147
SEP-1613: use.catchall() on inputSchema/outputSchema to support JSON Schema 2020-12 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1135
sampling: validate tools, tool_use, tool_result constraints by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/1156
fix: React to upstream RC schema changes for form mode elicitation requests by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1164
feat: implement SEP-1699 SSE polling via server-side disconnect by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1129
chore: bump package number for release by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1170

New Contributors

@nbarbettini made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1105
@m-henderson made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1116
@maxisbey made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1134
@dclark27 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1040
@Nayana-Parameswarappa made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1115

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.22.0...1.23.0

Open source →

1.23.0-beta.020 Nov 2025pre-releasewithdrawn: Use 1.23.1 or laterDeprecated

chore: Add deprecated marker to old elicitInput overload by @nbarbettini in https://github.com/modelcontextprotocol/typescript-sdk/pull/1142

Special Note: zod v4

This beta release adds support for zod v4, a highly requested addition.

Special thanks to @dclark27 @colinhacks for all the work on https://github.com/modelcontextprotocol/typescript-sdk/pull/1040 which adds this support while staying backwards compatible with zod v3!

NOTE: if you run into any issues with zod v4 in this SDK please raise an issue! We'll be monitoring actively for any issues while trying to use zod v4 as it's a highly anticipated update. In order to make this upgrade possible we needed to also require v3.25+ for zod v3. You may need to update your version of zod v3 if you've been using an older one. We're also making this a beta release while we get initial feedback on the update here.

What's Changed

Migrate to vitest from jest by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1074
ci: add workflow_dispatch trigger for manual CI runs by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1114
Fix: @types/node incompatibility with vite warnings on npm install by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1121
Fix: clean up accidental spec.types.ts by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1122
fix: Pass RequestInit options to auth requests by @dsp-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/1066
SEP-1036: URL Elicitation by @nbarbettini in https://github.com/modelcontextprotocol/typescript-sdk/pull/1105
add none to test and the router. by @m-henderson in https://github.com/modelcontextprotocol/typescript-sdk/pull/1116
[auth] Adjust scope management to line up with SEP-835 by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1133
chore: add .idea/ to .gitignore by @maxisbey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1134
chore: remove unused @types/eslint__js dependency by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1128
feat: url based client metadata registration (SEP 991) by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1127
feat: zod v4 with backwards compatibility for v3.25+ by @dclark27 in https://github.com/modelcontextprotocol/typescript-sdk/pull/1040
fix: remove pnpm lock and regenerate package-lock by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1138
docs: update installation instructions for zod peer dependency by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1139
Implement SEP-1577 - Sampling With Tools by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/1101
Follow up: unify v3 and v4 zod types via describe matrix and a test helper by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1141
chore: Add deprecated marker to old elicitInput overload by @nbarbettini in https://github.com/modelcontextprotocol/typescript-sdk/pull/1142
fix: Connect error in URL elicitation example by @nbarbettini in https://github.com/modelcontextprotocol/typescript-sdk/pull/1136
Support upscoping on insufficient_scope 403 by @Nayana-Parameswarappa in https://github.com/modelcontextprotocol/typescript-sdk/pull/1115
Support beta releases by publishing with --tag beta by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1146
Bump version to 1.23.0-beta.0 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1147

New Contributors

@nbarbettini made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1105
@m-henderson made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1116
@maxisbey made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1134
@dclark27 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1040
@Nayana-Parameswarappa made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1115

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.22.0...1.23.0-beta.0

Open source →

1.22.013 Nov 2025

registerTool: accept ZodType for input and output schema by @ksinder in https://github.com/modelcontextprotocol/typescript-sdk/pull/816

What's Changed

registerTool: accept ZodType<object> for input and output schema by @ksinder in https://github.com/modelcontextprotocol/typescript-sdk/pull/816
SEP-1319: Decouple Request Payloads, Remove passthrough iteration, Typecheck fixes by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1086
add pkg-pr-new bot by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1088
Upgrade to Node LTS by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1072
change step name by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1089
SEP-1034: Default values for Elicitation Schemas by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1096
SEP-1330: Compatibility with SEP-1034 by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1100
Implementation of SEP-986: Specify Format for Tool Names by @kentcdodds in https://github.com/modelcontextprotocol/typescript-sdk/pull/900
[auth] Fix march spec fallback for metadata discovery by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1108
chore: bump version for release by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1110

New Contributors

@ksinder made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/816

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.21.1...1.22.0

Open source →

1.21.17 Nov 2025Deprecated

Add @deprecated annotations to legacy APIs by @domdomegg in https://github.com/modelcontextprotocol/typescript-sdk/pull/1018

What's Changed

Only use path-based discovery URLs from the authorization server to discover metadata by @roadmapper in https://github.com/modelcontextprotocol/typescript-sdk/pull/1070
Add @deprecated annotations to legacy APIs by @domdomegg in https://github.com/modelcontextprotocol/typescript-sdk/pull/1018
fix: Support WWW-Authenticate scope param for SEP-835 by @chipgpt in https://github.com/modelcontextprotocol/typescript-sdk/pull/983
move CLI script to dedicated scripts directory by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1073
Check script which typechecks using Typescripts new Go port by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1075
FIX: use a nightly spec.types.ts by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1087
chore: bump version for release by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1085

New Contributors

@roadmapper made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1070

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.21.0...1.21.1

Open source →

1.21.03 Nov 2025

feat: pluggable JSON schema validator providers by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1012

What's Changed

feat: pluggable JSON schema validator providers by @mattzcarey in https://github.com/modelcontextprotocol/typescript-sdk/pull/1012
Update metadata.ts by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/1010
fix: Prefer the token_endpoint_auth_method response from DCR registration by @chipgpt in https://github.com/modelcontextprotocol/typescript-sdk/pull/1022
Fix: Non-existent tool, disabled tool and inputSchema validation return MCP protocol level instead of CallToolResult with isError: true by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/1044
chore: bump version to 1.21.0 for release by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1062

New Contributors

@chipgpt made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1022

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.20.2...1.21.0

Open source →

1.20.116 Oct 2025

fix: Add Accept header to auth metadata request by @SVLaursen in https://github.com/modelcontextprotocol/typescript-sdk/pull/901

What's Changed

fix: Add Accept header to auth metadata request by @SVLaursen in https://github.com/modelcontextprotocol/typescript-sdk/pull/901
Allow empty string as valid URL in DCR workflow by @fredericbarthelet in https://github.com/modelcontextprotocol/typescript-sdk/pull/987
docs: fix summary contents at readme by @starfish719 in https://github.com/modelcontextprotocol/typescript-sdk/pull/1025
chore: bump version to 1.20.1 for release by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/1032

New Contributors

@SVLaursen made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/901
@starfish719 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/1025

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.20.0...1.20.1

Open source →

1.18.225 Sept 2025

Updates the sampling code example in the README by @viniciuscsouza in https://github.com/modelcontextprotocol/typescript-sdk/pull/958

What's Changed

Updates the sampling code example in the README by @viniciuscsouza in https://github.com/modelcontextprotocol/typescript-sdk/pull/958
Use redirect Uri passed in in demoInMemoryOAuthProvider by @TylerLeonhardt in https://github.com/modelcontextprotocol/typescript-sdk/pull/931
fix(auth-router): correct Protected Resource Metadata for pathful RS and add explicit resourceServerUrl (RFC 9728) by @blustAI in https://github.com/modelcontextprotocol/typescript-sdk/pull/858
chore: update version to 1.18.2 for weekly release by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/970

New Contributors

@viniciuscsouza made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/958
@TylerLeonhardt made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/931
@blustAI made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/858

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.18.1...1.18.2

Open source →

1.18.011 Sept 2025

mcp: update SDK for SEP 973 + add to example server by @jesselumarie in https://github.com/modelcontextprotocol/typescript-sdk/pull/904

What's Changed

mcp: update SDK for SEP 973 + add to example server by @jesselumarie in https://github.com/modelcontextprotocol/typescript-sdk/pull/904
feat: add _meta field support to tool definitions by @knguyen-figma in https://github.com/modelcontextprotocol/typescript-sdk/pull/922
Fix automatic log level handling for sessionless connections by @cliffhall in https://github.com/modelcontextprotocol/typescript-sdk/pull/917
1.17.6 by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/936
1.18.0 by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/937
ignore icons for now by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/938

New Contributors

@jesselumarie made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/904
@knguyen-figma made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/922

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.17.5...1.18.0

Open source →

1.17.314 Aug 2025

Fix quit command in Example client with OAuth by @DaleSeo in https://github.com/modelcontextprotocol/typescript-sdk/pull/864

What's Changed

Fix quit command in Example client with OAuth by @DaleSeo in https://github.com/modelcontextprotocol/typescript-sdk/pull/864
fix: client import & server imports by @jatinsandilya in https://github.com/modelcontextprotocol/typescript-sdk/pull/851
fix: pass fetchfn parameter to registerClient and refreshAuthorizatio… by @arjunkmrm in https://github.com/modelcontextprotocol/typescript-sdk/pull/850
docs: correct parameter schema key in Dynamic Servers documentation by @bianbianzhu in https://github.com/modelcontextprotocol/typescript-sdk/pull/789
version: patch to 0.17.3 by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/878

New Contributors

@DaleSeo made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/864
@jatinsandilya made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/851
@arjunkmrm made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/850
@bianbianzhu made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/789

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.17.2...1.17.3

Open source →

1.17.024 Jul 2025

Add CODEOWNERS file for sdk by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/781

What's Changed

Add CODEOWNERS file for sdk by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/781
Add more robust base64 check by @cliffhall in https://github.com/modelcontextprotocol/typescript-sdk/pull/786
update codeowners by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/803
Fix indent by @jiec-msft in https://github.com/modelcontextprotocol/typescript-sdk/pull/807
fix: Explicitly declare accpet type to json when exchanging oauth token by @JoJoJoJoJoJoJo in https://github.com/modelcontextprotocol/typescript-sdk/pull/801
feat: support oidc discovery in client sdk by @xiaoyijun in https://github.com/modelcontextprotocol/typescript-sdk/pull/652
fix: remove extraneous code block in README.md by @sd0ric4 in https://github.com/modelcontextprotocol/typescript-sdk/pull/791
Bump form-data from 4.0.2 to 4.0.4 in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/modelcontextprotocol/typescript-sdk/pull/798
Bump version 1.17.0 by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/810

New Contributors 🙏

@jiec-msft made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/807
@sd0ric4 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/791

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.16.0...1.17.0

Open source →

1.16.017 Jul 2025

Add type compatibility test between SDK and spec types by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/729

What's Changed

Add type compatibility test between SDK and spec types by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/729
Add OIDC ID token support by @dankelleher in https://github.com/modelcontextprotocol/typescript-sdk/pull/680
Add prompt=consent for OIDC offline_access scope by @dankelleher in https://github.com/modelcontextprotocol/typescript-sdk/pull/681
Non-critical: Readme syntax and typographical error fixes by @freakynit in https://github.com/modelcontextprotocol/typescript-sdk/pull/765
make client side client_id generation configurable in the oauth router by @cdaguerre in https://github.com/modelcontextprotocol/typescript-sdk/pull/734
Adding invalidateCredentials() to OAuthClientProvider by @geelen in https://github.com/modelcontextprotocol/typescript-sdk/pull/570
fix: use authorization_server_url as issuer when fetching metadata by @JoJoJoJoJoJoJo in https://github.com/modelcontextprotocol/typescript-sdk/pull/763
feat(protocol): Debounce notifications to improve network efficiancy by @jneums in https://github.com/modelcontextprotocol/typescript-sdk/pull/746
fix(731): StreamableHTTPClientTransport Fails to Reconnect on Non-Resumable Streams by @jneums in https://github.com/modelcontextprotocol/typescript-sdk/pull/732
fix: consistently use consumer-provided fetch function by @LucaButBoring in https://github.com/modelcontextprotocol/typescript-sdk/pull/767
fix client id issuance date should only be sent when generated by @cdaguerre in https://github.com/modelcontextprotocol/typescript-sdk/pull/775
1.16.0 by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/779

New Contributors 🙏

@dankelleher made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/680
@freakynit made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/765
@cdaguerre made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/734
@JoJoJoJoJoJoJo made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/763
@jneums made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/746
@LucaButBoring made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/767

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.15.1...1.16.0

Open source →

1.15.110 Jul 2025

fix(client): Some mcp server need default env(#393, #196) by @sunrabbit123 in https://github.com/modelcontextprotocol/typescript-sdk/pull/394

What's Changed

fix(client): Some mcp server need default env(#393, #196) by @sunrabbit123 in https://github.com/modelcontextprotocol/typescript-sdk/pull/394
feat: Add CORS configuration for browser-based MCP clients by @jerome3o-anthropic in https://github.com/modelcontextprotocol/typescript-sdk/pull/713
Add onsessionclosed hook to StreamableHTTPServerTransport by @jerome3o-anthropic in https://github.com/modelcontextprotocol/typescript-sdk/pull/743
add custom headers on initial _startOrAuth call by @anthonjn in https://github.com/modelcontextprotocol/typescript-sdk/pull/318
Improve stdio test Windows compatibility and refactor command logic by @HoberMin in https://github.com/modelcontextprotocol/typescript-sdk/pull/284
Add missing app.listen error handling to server examples by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/749
fix(server): validate expiresAt token value for non existence by @christian-bromann in https://github.com/modelcontextprotocol/typescript-sdk/pull/446
[auth]: support oauth client_secret_basic / none / custom methods by @jaredhanson, @SightStudio, @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/720
feat: support async callbacks for onsessioninitialized and onsessionclosed by @jerome3o-anthropic in https://github.com/modelcontextprotocol/typescript-sdk/pull/751
Fix oauth well-known paths to retain path and query by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/756
auth: fetch AS metadata in well-known subpath from serverUrl even when PRM returns external AS by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/752

New Contributors

@sunrabbit123 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/394
@anthonjn made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/318
@HoberMin made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/284

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.15.0...1.15.1

Open source →

1.13.31 Jul 2025

Implement DNS Rebinding Protections per spec by @ddworken in https://github.com/modelcontextprotocol/typescript-sdk/pull/565

What's Changed

Implement DNS Rebinding Protections per spec by @ddworken in https://github.com/modelcontextprotocol/typescript-sdk/pull/565
fix lint by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/704
fix: add missing eventsource-parser dependency by @domnit in https://github.com/modelcontextprotocol/typescript-sdk/pull/424
fix: add windows env PROGRAMFILES, avoid some exe can not be found by @muzea in https://github.com/modelcontextprotocol/typescript-sdk/pull/386
add overloads for registerResource method in McpServer class by @kentcdodds in https://github.com/modelcontextprotocol/typescript-sdk/pull/661
fix: extra headers when they are a Headers object by @garciasdos in https://github.com/modelcontextprotocol/typescript-sdk/pull/571
fix: missing "properties" property in empty schema by @sinedied in https://github.com/modelcontextprotocol/typescript-sdk/pull/598
fix: Expose the MCP child process PID as an accessible property in StdioClientTransport by @XiaofuHuang in https://github.com/modelcontextprotocol/typescript-sdk/pull/455
fix: add type safety for tool output schemas in ToolCallback by @sushichan044 in https://github.com/modelcontextprotocol/typescript-sdk/pull/670
doc minimum node version requirment by @marcopeg in https://github.com/modelcontextprotocol/typescript-sdk/pull/463
docs: add error handling when it fails to start HTTP server by @formulahendry in https://github.com/modelcontextprotocol/typescript-sdk/pull/371
Added Sampling Example to README by @RishiNandha in https://github.com/modelcontextprotocol/typescript-sdk/pull/698
Returning undefined from discoverOAuthMetadata for CORS errors by @geelen in https://github.com/modelcontextprotocol/typescript-sdk/pull/717
Bump version to 1.13.3 by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/719

New Contributors 🙏

@ddworken made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/565
@domnit made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/424
@muzea made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/386
@kentcdodds made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/661
@garciasdos made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/571
@sinedied made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/598
@XiaofuHuang made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/455
@sushichan044 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/670
@marcopeg made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/463
@formulahendry made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/371
@RishiNandha made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/698

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.13.2...1.13.3

Open source →

1.13.226 Jun 2025

Fix /.well-known/oauth-authorization-server dropping path by @calclavia in https://github.com/modelcontextprotocol/typescript-sdk/pull/687

What's Changed

Fix /.well-known/oauth-authorization-server dropping path by @calclavia in https://github.com/modelcontextprotocol/typescript-sdk/pull/687
Fallback for /.well-known/oauth-authorization-server dropping path by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/692
[auth] refactor resource selection to not include resource if PRM is not present by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/693
fix: skip validation if tool reports error by @Areo-Joe in https://github.com/modelcontextprotocol/typescript-sdk/pull/655
feat(shared/auth): support software_statement in OAuthClientMetadata by @chrisdickinson in https://github.com/modelcontextprotocol/typescript-sdk/pull/696
Show session id per request in simpleStreamableHttp example server by @cliffhall in https://github.com/modelcontextprotocol/typescript-sdk/pull/640
Raw request propagation in tools - passed to callbacks via RequestHandlerExtra<ServerRequest, ServerNotification> by @KKonstantinov in https://github.com/modelcontextprotocol/typescript-sdk/pull/627
Update readme file to include a tip to allow mcp-session-id in CORS when using StreamableHTTP by @Achintha444 in https://github.com/modelcontextprotocol/typescript-sdk/pull/633
Pr/protocol overwriting transport hooks by @nichtsam in https://github.com/modelcontextprotocol/typescript-sdk/pull/477
docs: Add clarifying comments for stateless streamable HTTP endpoints by @dhodun in https://github.com/modelcontextprotocol/typescript-sdk/pull/542
Bump formidable from 3.5.2 to 3.5.4 in the npm_and_yarn group across 1 directory by @dependabot in https://github.com/modelcontextprotocol/typescript-sdk/pull/428
test(server): add more tests for SSEServerTransport class by @christian-bromann in https://github.com/modelcontextprotocol/typescript-sdk/pull/391
Update version of the package to 1.13.2 by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/701

New Contributors 🙏

@calclavia made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/687
@Areo-Joe made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/655
@KKonstantinov made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/627
@Achintha444 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/633
@nichtsam made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/477
@dhodun made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/542
@christian-bromann made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/391

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.13.1...1.13.2

Open source →

1.13.123 Jun 2025

simpleStreamableHttp: fix example code by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/660

What's Changed

simpleStreamableHttp: fix example code by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/660
build: add watching script targets for build & simple streamable http server by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/663
feat: remove console statements from SDK code by @ashwin-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/668
[auth] adjust default validation for resource parameter in client flow, and server example by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/664
fix(client/sse): extract protected resource from eventsource 401 by @chrisdickinson in https://github.com/modelcontextprotocol/typescript-sdk/pull/675
1.13.1 by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/683

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.13.0...1.13.1

Open source →

1.13.018 Jun 2025

https://github.com/modelcontextprotocol/modelcontextprotocol/releases/tag/2025-06-18

🚀 Implementation for Spec revision 2025-06-18

https://github.com/modelcontextprotocol/modelcontextprotocol/releases/tag/2025-06-18

feat: implement MCP-Protocol-Version header requirement for HTTP transport by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/614
Rename ResourceReference to ResourceTemplateReference by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/619
Adds _meta to additional interface types by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/630
Add title to tools, resources, prompts by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/631
Add support for resource link by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/632
Include context into completions by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/634
Add missing _meta fields to match spec requirements by @felixweinberger in https://github.com/modelcontextprotocol/typescript-sdk/pull/636
Introduce Elicitation capability by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/520
update _meta usage guidance in types.ts by @bhosmer-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/639
Jerome/fix/dev oauth server required scopes change by @jerome3o-anthropic in https://github.com/modelcontextprotocol/typescript-sdk/pull/629
remove hasCustomTitle by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/645
update latest protocol version by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/643
change version by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/647
RFC 8707 Resource Indicators Implementation by @ochafik in https://github.com/modelcontextprotocol/typescript-sdk/pull/638
rename decline to reject by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/657

New Contributors 🙏

@ochafik made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/614
@felixweinberger made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/636

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.12.3...1.13.0

Open source →

1.12.022 May 2025

feat: Add support for separate Authorization Server / Resource server in server flow (spec: DRAFT-2025-v2) by @pcarleton in https://github.com/modelco

Authorization spec: DRAFT-2025-v2 🔐 🚀

feat: Add support for separate Authorization Server / Resource server in server flow (spec: DRAFT-2025-v2) by @pcarleton in https://github.com/modelcontextprotocol/typescript-sdk/pull/503
Feat: Separate authorization server and resource server on client auth flow by @0Itsuki0 in https://github.com/modelcontextprotocol/typescript-sdk/pull/416
Example Auth client by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/526

Other changes

Add support for message field in progress notifications by @bhosmer-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/502
Fix Ajv import compatibility issue by downgrading to v6 by @bhosmer-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/517
fix: ProxyOAuthServerProvider: redirect_uri missing in token request by @shubham-lohar in https://github.com/modelcontextprotocol/typescript-sdk/pull/519
Save existing refresh_token in store if no new refresh_token is returned by @fredericbarthelet in https://github.com/modelcontextprotocol/typescript-sdk/pull/483 https://github.com/modelcontextprotocol/typescript-sdk/pull/527
Add state param to OAuth provider by @jescalan in https://github.com/modelcontextprotocol/typescript-sdk/pull/529
Fix StreamableHttp example for tool calls - have a separate option for testing notifications resumption by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/534

New Contributors

@0Itsuki0 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/416
@shubham-lohar made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/519
@jescalan made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/529

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.11.4...1.12.0

Open source →

1.11.315 May 2025

fix: preserve custom paths in SSE endpoint URLs by @bhosmer-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/466

What's Changed

fix: preserve custom paths in SSE endpoint URLs by @bhosmer-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/466
chore: fix cross-spawn version to 7.0.5 (issue: #488) by @rafaelportomoura in https://github.com/modelcontextprotocol/typescript-sdk/pull/489
[FEAT] added support for AuthInfo in extra for StreamableHTTPServerTransport by @its-nikhil in https://github.com/modelcontextprotocol/typescript-sdk/pull/399
feat(auth): support custom scope in authorization requests by @xiaoyijun in https://github.com/modelcontextprotocol/typescript-sdk/pull/491
Fix notificaions in README.md by @Boyquotes in https://github.com/modelcontextprotocol/typescript-sdk/pull/480
docs: Fix import paths for ProxyOAuthServerProvider in README by @grimmerk in https://github.com/modelcontextprotocol/typescript-sdk/pull/457
Fix Table of Contents in README and markdown linter warnings. by @petervandenabeele in https://github.com/modelcontextprotocol/typescript-sdk/pull/449

New Contributors

@rafaelportomoura made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/489
@its-nikhil made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/399
@xiaoyijun made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/491
@Boyquotes made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/480
@grimmerk made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/457
@petervandenabeele made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/449

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.11.2...1.11.3

Open source →

1.11.01 May 2025

Adding support for Tools Annotations for better describing tool behavior, like whether it is read-only or destructive, as per protocol version 2025-03

🚀 Tool Annotations

Adding support for Tools Annotations for better describing tool behavior, like whether it is read-only or destructive, as per protocol version 2025-03-26

Spec Version Update

Since we implemented most of the features in the recent spec we are updating the latest protocol version

Other Changes

Pass requestId to handlers via metadata by @lforst in https://github.com/modelcontextprotocol/typescript-sdk/pull/358
stateless had a wrong example by @TomasRup in https://github.com/modelcontextprotocol/typescript-sdk/pull/338
fix SSE transport server examples by @ihrpr in https://github.com/modelcontextprotocol/typescript-sdk/pull/388
Update README.md to include working examples by @simonedstrom96 in https://github.com/modelcontextprotocol/typescript-sdk/pull/384
Pass request _meta to request handlers extra param by @iamarcel in https://github.com/modelcontextprotocol/typescript-sdk/pull/328
Update stateless streamable http usecase by @c121914yu in https://github.com/modelcontextprotocol/typescript-sdk/pull/417
Add 401 during POST request test case on StreamableHTTP transport to check auth flow by @fredericbarthelet in https://github.com/modelcontextprotocol/typescript-sdk/pull/411
Ensure JSONRPCError messages are sent for streamable http by @mhart in https://github.com/modelcontextprotocol/typescript-sdk/pull/409
nit: fix the comment format in the streamableHTTP.ts by @botengyao in https://github.com/modelcontextprotocol/typescript-sdk/pull/406
comment: fix stateless comments that no session-id is included in any responses by @botengyao in https://github.com/modelcontextprotocol/typescript-sdk/pull/403
Add stderr access before start by @hmwildermuth in https://github.com/modelcontextprotocol/typescript-sdk/pull/437

Please report any issues at https://github.com/modelcontextprotocol/typescript-sdk/issues.

New Contributors

@lforst made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/358
@bhosmer-ant made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/309
@TomasRup made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/338
@simonedstrom96 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/384
@iamarcel made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/328
@c121914yu made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/417
@mhart made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/409
@botengyao made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/406
@hmwildermuth made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/437

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.10.2...1.11.0

Open source →

1.10.017 Apr 2025

This is the first release supporting the new Streamable HTTP transport from protocol version 2025-03-26, which supersedes the SSE transport from proto

Streamable HTTP release

This is the first release supporting the new Streamable HTTP transport from protocol version 2025-03-26, which supersedes the SSE transport from protocol version 2024-11-05. 🎉

See the Streamable HTTP section of the README and the included examples for how to use this new transport in your client or server.
There's also a guide on backwards compatibility, to maintain support with SSE clients or servers while the ecosystem upgrades to Streamable HTTP.

Please report any issues at https://github.com/modelcontextprotocol/typescript-sdk/issues.

Other Changes

Improve SSE endpoint sessionId parameter handling by @akazwz in https://github.com/modelcontextprotocol/typescript-sdk/pull/177
Mutations for McpServer by @geelen in https://github.com/modelcontextprotocol/typescript-sdk/pull/247
StreamableHTTPClientTransport cleanup / fixes by @beaulac in https://github.com/modelcontextprotocol/typescript-sdk/pull/300
Add helper functions to distinguish between jsonRPC message types by @fredericbarthelet in https://github.com/modelcontextprotocol/typescript-sdk/pull/281
Bump to version 1.10.0 by @cliffhall in https://github.com/modelcontextprotocol/typescript-sdk/pull/305
Include Authorization Info in Tool Calls (and request handlers generally) by @allenzhou101 in https://github.com/modelcontextprotocol/typescript-sdk/pull/166

New Contributors

@akazwz made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/177
@geelen made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/247
@beaulac made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/300
@fredericbarthelet made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/281
@cliffhall made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/305

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.9.0...1.10.0

Open source →

1.9.07 Apr 2025

Correctly pass redirect_uri to tokens call by @praboud-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/222

What's Changed

Correctly pass redirect_uri to tokens call by @praboud-ant in https://github.com/modelcontextprotocol/typescript-sdk/pull/222
Add audio content by @nathanArseneau in https://github.com/modelcontextprotocol/typescript-sdk/pull/252
Fix bug in reset timeout on progress by @Ozamatash in https://github.com/modelcontextprotocol/typescript-sdk/pull/160
Add Proxy OAuth Server Provider by @allenzhou101 in https://github.com/modelcontextprotocol/typescript-sdk/pull/159
Bump pkce up to 5.0.0 to fix CJS dependency issue by @heyitsaamir in https://github.com/modelcontextprotocol/typescript-sdk/pull/254
#89 NPM provenance added by @davolokh in https://github.com/modelcontextprotocol/typescript-sdk/pull/190
console.error pollution logs removed in tests by @davolokh in https://github.com/modelcontextprotocol/typescript-sdk/pull/194
Fixing for windows terminal forcing \r\n by @Shchvova in https://github.com/modelcontextprotocol/typescript-sdk/pull/214
docs: Update README for client method usage by @stonexer in https://github.com/modelcontextprotocol/typescript-sdk/pull/183
feat: expose variableNames to retrieve all parameters from UriTemplate by @li-yechao in https://github.com/modelcontextprotocol/typescript-sdk/pull/188
fix: 🐛 can't establish sse when server side enable compress by @Exlau in https://github.com/modelcontextprotocol/typescript-sdk/pull/231
docs: Update README to not specify invalid capabilities by @morinokami in https://github.com/modelcontextprotocol/typescript-sdk/pull/265
fix: Ensure the correct capability is checked for completion/complete by @morinokami in https://github.com/modelcontextprotocol/typescript-sdk/pull/268
feat: Add completions capability in ServerCapabilitiesSchema by @morinokami in https://github.com/modelcontextprotocol/typescript-sdk/pull/269
✨ (client/index.ts): add optional RequestOptions parameter to connect… by @nanbingxyz in https://github.com/modelcontextprotocol/typescript-sdk/pull/224

New Contributors

@praboud-ant made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/222
@nathanArseneau made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/252
@allenzhou101 made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/159
@heyitsaamir made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/254
@davolokh made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/190
@Shchvova made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/214
@stonexer made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/183
@li-yechao made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/188
@Exlau made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/231
@morinokami made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/265
@nanbingxyz made their first contribution in https://github.com/modelcontextprotocol/typescript-sdk/pull/224

Full Changelog: https://github.com/modelcontextprotocol/typescript-sdk/compare/1.8.0...1.9.0

Open source →

@modelcontextprotocol/sdk

Release timeline

Releases

Upgrade notes

What's Changed

New Contributors

Upgrade notes

What's Changed

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

What's Changed

New Contributors

What's Changed

What's Changed

New Contributors

What's Changed

What's Changed

New Contributors

What's Changed

New Contributors

Summary

What's Changed

New Contributors

Fixed:

What's Changed

New Contributors

Special Note: zod v4

What's Changed

New Contributors

What's Changed

New Contributors

What's changed

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors 🙏

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

What's Changed

What's Changed

New Contributors

What's Changed

What's Changed

What's Changed

New Contributors 🙏

What's Changed

New Contributors 🙏

What's Changed

New Contributors

What's Changed

What's Changed

What's Changed

New Contributors 🙏

What's Changed

New Contributors 🙏

What's Changed