# @ai-sdk/mcp

## 1.0.46

### Patch Changes

- 1f817db: fix(mcp): await addClientAuthentication in token exchange and refresh

## 1.0.45

### Patch Changes

- ec5fceb: fix(mcp): respond to ping requests with an empty result per JSON-RPC spec (closes #6282)

## 1.0.44

### Patch Changes

- 77775a4: feat(mcp): expose `statusCode`, `url`, and `responseBody` on `MCPClientError` for HTTP transport failures

  `MCPClientError` now carries structured HTTP context when it originates from the
  streamable HTTP transport. This lets downstream consumers (e.g. agent frameworks
  that need to decide whether to fall back from streamable HTTP to legacy SSE
  transport per the MCP spec) branch on the actual response status without parsing
  the error message string.

  Fields are optional — they remain `undefined` for stdio transport errors and for
  non-response failures (network errors, aborts).

## 1.0.43

### Patch Changes

- e2b923f: fix(mcp): deduplicate auth refresh on http transport

## 1.0.42

### Patch Changes

- 725f2ed: feat(mcp): expose server instructions to be accessible through client
- 7281592: fix(mcp): use negotiated protocol version in transport request headers

## 1.0.41

### Patch Changes

- f591416: feat(ai): add toolMetadata for tool specific metdata
- Updated dependencies [f591416]
  - @ai-sdk/provider-utils@4.0.27

## 1.0.40

### Patch Changes

- 221a984: Add `resource_link` content type to `CallToolResultSchema` and `PromptMessageSchema` per MCP spec. Fixes hard rejection when MCP servers return `resource_link` content parts with zod ≥ 4.4.x.
- 0084974: feat(mcp): deprecate name and use clientName for MCPClient

## 1.0.39

### Patch Changes

- 7beadf0: feat(mcp): propagate the server name through dynamic tool parts
- Updated dependencies [7beadf0]
  - @ai-sdk/provider-utils@4.0.26

## 1.0.38

### Patch Changes

- a727da4: chore: ensure consistent import handling and avoid import duplicates or cycles
- 5fee301: fix(mcp): prevent prototype pollution by using secureJsonParse
- Updated dependencies [a727da4]
  - @ai-sdk/provider-utils@4.0.25
  - @ai-sdk/provider@3.0.10

## 1.0.37

### Patch Changes

- a7f3c72: trigger release for all packages after provenance setup
- Updated dependencies [a7f3c72]
  - @ai-sdk/provider@3.0.9
  - @ai-sdk/provider-utils@4.0.24

## 1.0.36

### Patch Changes

- 9a8d276: feat(mcp): surface 'serverInfo' exposed from the MCP server

## 1.0.35

### Patch Changes

- 941ebf2: fix(mcp): bypass outputSchema validation when tool returns isError

## 1.0.34

### Patch Changes

- 1141b93: feat(mcp): allow custom fetch for HTTP and SSE transports

## 1.0.33

### Patch Changes

- Updated dependencies [6247886]
  - @ai-sdk/provider-utils@4.0.23

## 1.0.32

### Patch Changes

- 47c6af0: fix(mcp): strip trailing slash from OAuth resource parameter

## 1.0.31

### Patch Changes

- Updated dependencies [0469aed]
  - @ai-sdk/provider-utils@4.0.22

## 1.0.30

### Patch Changes

- 055cd68: fix: publish v6 to latest npm dist tag
- Updated dependencies [055cd68]
  - @ai-sdk/provider-utils@4.0.21

## 1.0.29

### Patch Changes

- cc8b506: feat(mcp): add `redirect` option to `MCPTransportConfig` for controlling HTTP redirect behavior

## 1.0.28

### Patch Changes

- 0c86a13: fix(mcp): validate state param in oauth flow

## 1.0.27

### Patch Changes

- 1920b22: fix(mcp): add MCP protocol version 2025-11-25 to supported versions

## 1.0.26

### Patch Changes

- Updated dependencies [64ac0fd]
  - @ai-sdk/provider-utils@4.0.20

## 1.0.25

### Patch Changes

- Updated dependencies [ad4cfc2]
  - @ai-sdk/provider-utils@4.0.19

## 1.0.24

### Patch Changes

- Updated dependencies [824b295]
  - @ai-sdk/provider-utils@4.0.18

## 1.0.23

### Patch Changes

- Updated dependencies [08336f1]
  - @ai-sdk/provider-utils@4.0.17

## 1.0.22

### Patch Changes

- Updated dependencies [58bc42d]
  - @ai-sdk/provider-utils@4.0.16

## 1.0.21

### Patch Changes

- Updated dependencies [4024a3a]
  - @ai-sdk/provider-utils@4.0.15

## 1.0.20

### Patch Changes

- 60ee2df: feat(mcp): expose serializable data from the server tools

## 1.0.19

### Patch Changes

- Updated dependencies [7168375]
  - @ai-sdk/provider@3.0.8
  - @ai-sdk/provider-utils@4.0.14

## 1.0.18

### Patch Changes

- Updated dependencies [53f6731]
  - @ai-sdk/provider@3.0.7
  - @ai-sdk/provider-utils@4.0.13

## 1.0.17

### Patch Changes

- Updated dependencies [96936e5]
  - @ai-sdk/provider-utils@4.0.12

## 1.0.16

### Patch Changes

- 8d022fd: fix(mcp): support image returns in tool results

## 1.0.15

### Patch Changes

- Updated dependencies [2810850]
  - @ai-sdk/provider-utils@4.0.11
  - @ai-sdk/provider@3.0.6

## 1.0.14

### Patch Changes

- Updated dependencies [462ad00]
  - @ai-sdk/provider-utils@4.0.10

## 1.0.13

### Patch Changes

- 4de5a1d: chore: excluded tests from src folder in npm package
- Updated dependencies [4de5a1d]
  - @ai-sdk/provider@3.0.5
  - @ai-sdk/provider-utils@4.0.9

## 1.0.12

### Patch Changes

- 8dc54db: chore: add src folders to package bundle

## 1.0.11

### Patch Changes

- d80fc3b: feat(mcp): capture server title from top level

## 1.0.10

### Patch Changes

- Updated dependencies [5c090e7]
  - @ai-sdk/provider@3.0.4
  - @ai-sdk/provider-utils@4.0.8

## 1.0.9

### Patch Changes

- ec84ffd: fix(mcp): lenient JSON-RPC parsing for http transport

## 1.0.8

### Patch Changes

- Updated dependencies [46f46e4]
  - @ai-sdk/provider-utils@4.0.7

## 1.0.7

### Patch Changes

- Updated dependencies [1b11dcb]
  - @ai-sdk/provider-utils@4.0.6
  - @ai-sdk/provider@3.0.3

## 1.0.6

### Patch Changes

- Updated dependencies [34d1c8a]
  - @ai-sdk/provider-utils@4.0.5

## 1.0.5

### Patch Changes

- 9cc0f88: feat(mcp): add support for structuredContent / outputSchema for typed tool outputs

## 1.0.4

### Patch Changes

- Updated dependencies [d937c8f]
  - @ai-sdk/provider@3.0.2
  - @ai-sdk/provider-utils@4.0.4

## 1.0.3

### Patch Changes

- Updated dependencies [0b429d4]
  - @ai-sdk/provider-utils@4.0.3

## 1.0.2

### Patch Changes

- 863d34f: fix: trigger release to update `@latest`
- Updated dependencies [863d34f]
  - @ai-sdk/provider@3.0.1
  - @ai-sdk/provider-utils@4.0.2

## 1.0.1

### Patch Changes

- Updated dependencies [29264a3]
  - @ai-sdk/provider-utils@4.0.1

## 1.0.0

### Major Changes

- eca63f3: feat(ai): add OAuth for MCP clients + refactor to new package

  This change replaces

  ```ts
  import { experimental_createMCPClient } from "ai";
  import { Experimental_StdioMCPTransport } from "ai/mcp-stdio";
  ```

  with

  ```ts
  import { experimental_createMCPClient } from "@ai-sdk/mcp";
  import { Experimental_StdioMCPTransport } from "@ai-sdk/mcp/mcp-stdio";
  ```

### Patch Changes

- 90ede04: feat(mcp): make MCPClient stable
- 6f1577e: fix(mcp): pass json header for refreshAuth
- 17c04d4: feat(mcp): expose `_meta` field from MCP tool definitions
- 1cff766: feat(packages/mcp): add support for MCP server prompts exposed
- 3ed5519: chore: rename ToolCallOptions to ToolExecutionOptions
- ba2ca2d: feat(mcp): add the possibility to define client version in mcp client definition
- f702df2: feat(mcp): add client elicitation support
- 5939b92: feat(mcp): adding resources support to MCP client
- Updated dependencies
  - @ai-sdk/provider@3.0.0
  - @ai-sdk/provider-utils@4.0.0

## 1.0.0-beta.46

### Patch Changes

- Updated dependencies [475189e]
  - @ai-sdk/provider@3.0.0-beta.32
  - @ai-sdk/provider-utils@4.0.0-beta.59

## 1.0.0-beta.45

### Patch Changes

- Updated dependencies [2625a04]
  - @ai-sdk/provider@3.0.0-beta.31
  - @ai-sdk/provider-utils@4.0.0-beta.58

## 1.0.0-beta.44

### Patch Changes

- Updated dependencies [cbf52cd]
  - @ai-sdk/provider@3.0.0-beta.30
  - @ai-sdk/provider-utils@4.0.0-beta.57

## 1.0.0-beta.43

### Patch Changes

- Updated dependencies [9549c9e]
  - @ai-sdk/provider@3.0.0-beta.29
  - @ai-sdk/provider-utils@4.0.0-beta.56

## 1.0.0-beta.42

### Patch Changes

- Updated dependencies [50b70d6]
  - @ai-sdk/provider-utils@4.0.0-beta.55

## 1.0.0-beta.41

### Patch Changes

- Updated dependencies [9061dc0]
  - @ai-sdk/provider-utils@4.0.0-beta.54
  - @ai-sdk/provider@3.0.0-beta.28

## 1.0.0-beta.40

### Patch Changes

- 90ede04: feat(mcp): make MCPClient stable

## 1.0.0-beta.39

### Patch Changes

- Updated dependencies [366f50b]
  - @ai-sdk/provider@3.0.0-beta.27
  - @ai-sdk/provider-utils@4.0.0-beta.53

## 1.0.0-beta.38

### Patch Changes

- Updated dependencies [763d04a]
  - @ai-sdk/provider-utils@4.0.0-beta.52

## 1.0.0-beta.37

### Patch Changes

- Updated dependencies [c1efac4]
  - @ai-sdk/provider-utils@4.0.0-beta.51

## 1.0.0-beta.36

### Patch Changes

- Updated dependencies [32223c8]
  - @ai-sdk/provider-utils@4.0.0-beta.50

## 1.0.0-beta.35

### Patch Changes

- Updated dependencies [83e5744]
  - @ai-sdk/provider-utils@4.0.0-beta.49

## 1.0.0-beta.34

### Patch Changes

- Updated dependencies [960ec8f]
  - @ai-sdk/provider-utils@4.0.0-beta.48

## 1.0.0-beta.33

### Patch Changes

- Updated dependencies [e9e157f]
  - @ai-sdk/provider-utils@4.0.0-beta.47

## 1.0.0-beta.32

### Patch Changes

- Updated dependencies [81e29ab]
  - @ai-sdk/provider-utils@4.0.0-beta.46

## 1.0.0-beta.31

### Patch Changes

- Updated dependencies [3bd2689]
  - @ai-sdk/provider@3.0.0-beta.26
  - @ai-sdk/provider-utils@4.0.0-beta.45

## 1.0.0-beta.30

### Patch Changes

- 6f1577e: fix(mcp): pass json header for refreshAuth

## 1.0.0-beta.29

### Patch Changes

- Updated dependencies [53f3368]
  - @ai-sdk/provider@3.0.0-beta.25
  - @ai-sdk/provider-utils@4.0.0-beta.44

## 1.0.0-beta.28

### Patch Changes

- Updated dependencies [dce03c4]
  - @ai-sdk/provider-utils@4.0.0-beta.43
  - @ai-sdk/provider@3.0.0-beta.24

## 1.0.0-beta.27

### Patch Changes

- 3ed5519: chore: rename ToolCallOptions to ToolExecutionOptions
- Updated dependencies [3ed5519]
  - @ai-sdk/provider-utils@4.0.0-beta.42

## 1.0.0-beta.26

### Patch Changes

- 17c04d4: feat(mcp): expose `_meta` field from MCP tool definitions

## 1.0.0-beta.25

### Patch Changes

- Updated dependencies [1bd7d32]
  - @ai-sdk/provider-utils@4.0.0-beta.41
  - @ai-sdk/provider@3.0.0-beta.23

## 1.0.0-beta.24

### Patch Changes

- Updated dependencies [544d4e8]
  - @ai-sdk/provider-utils@4.0.0-beta.40
  - @ai-sdk/provider@3.0.0-beta.22

## 1.0.0-beta.23

### Patch Changes

- Updated dependencies [954c356]
  - @ai-sdk/provider-utils@4.0.0-beta.39
  - @ai-sdk/provider@3.0.0-beta.21

## 1.0.0-beta.22

### Patch Changes

- Updated dependencies [03849b0]
  - @ai-sdk/provider-utils@4.0.0-beta.38

## 1.0.0-beta.21

### Patch Changes

- Updated dependencies [457318b]
  - @ai-sdk/provider@3.0.0-beta.20
  - @ai-sdk/provider-utils@4.0.0-beta.37

## 1.0.0-beta.20

### Patch Changes

- Updated dependencies [8d9e8ad]
  - @ai-sdk/provider@3.0.0-beta.19
  - @ai-sdk/provider-utils@4.0.0-beta.36

## 1.0.0-beta.19

### Patch Changes

- Updated dependencies [10d819b]
  - @ai-sdk/provider@3.0.0-beta.18
  - @ai-sdk/provider-utils@4.0.0-beta.35

## 1.0.0-beta.18

### Patch Changes

- ba2ca2d: feat(mcp): add the possibility to define client version in mcp client definition

## 1.0.0-beta.17

### Patch Changes

- f702df2: feat(mcp): add client elicitation support

## 1.0.0-beta.16

### Patch Changes

- Updated dependencies [db913bd]
  - @ai-sdk/provider@3.0.0-beta.17
  - @ai-sdk/provider-utils@4.0.0-beta.34

## 1.0.0-beta.15

### Patch Changes

- Updated dependencies [b681d7d]
  - @ai-sdk/provider@3.0.0-beta.16
  - @ai-sdk/provider-utils@4.0.0-beta.33

## 1.0.0-beta.14

### Patch Changes

- Updated dependencies [32d8dbb]
  - @ai-sdk/provider-utils@4.0.0-beta.32

## 1.0.0-beta.13

### Patch Changes

- 1cff766: feat(packages/mcp): add support for MCP server prompts exposed

## 1.0.0-beta.12

### Patch Changes

- Updated dependencies [bb36798]
  - @ai-sdk/provider@3.0.0-beta.15
  - @ai-sdk/provider-utils@4.0.0-beta.31

## 1.0.0-beta.11

### Patch Changes

- Updated dependencies [4f16c37]
  - @ai-sdk/provider-utils@4.0.0-beta.30

## 1.0.0-beta.10

### Patch Changes

- Updated dependencies [af3780b]
  - @ai-sdk/provider@3.0.0-beta.14
  - @ai-sdk/provider-utils@4.0.0-beta.29

## 1.0.0-beta.9

### Patch Changes

- Updated dependencies [016b111]
  - @ai-sdk/provider-utils@4.0.0-beta.28

## 1.0.0-beta.8

### Patch Changes

- Updated dependencies [37c58a0]
  - @ai-sdk/provider@3.0.0-beta.13
  - @ai-sdk/provider-utils@4.0.0-beta.27

## 1.0.0-beta.7

### Patch Changes

- Updated dependencies [d1bdadb]
  - @ai-sdk/provider@3.0.0-beta.12
  - @ai-sdk/provider-utils@4.0.0-beta.26

## 1.0.0-beta.6

### Patch Changes

- Updated dependencies [4c44a5b]
  - @ai-sdk/provider@3.0.0-beta.11
  - @ai-sdk/provider-utils@4.0.0-beta.25

## 1.0.0-beta.5

### Patch Changes

- Updated dependencies [0c3b58b]
  - @ai-sdk/provider@3.0.0-beta.10
  - @ai-sdk/provider-utils@4.0.0-beta.24

## 1.0.0-beta.4

### Patch Changes

- Updated dependencies [a755db5]
  - @ai-sdk/provider@3.0.0-beta.9
  - @ai-sdk/provider-utils@4.0.0-beta.23

## 1.0.0-beta.3

### Patch Changes

- 5939b92: feat(mcp): adding resources support to MCP client

## 1.0.0-beta.2

### Patch Changes

- Updated dependencies [58920e0]
  - @ai-sdk/provider-utils@4.0.0-beta.22

## 1.0.0-beta.1

### Patch Changes

- Updated dependencies [293a6b7]
  - @ai-sdk/provider-utils@4.0.0-beta.21

## 1.0.0-beta.0

### Major Changes

- eca63f3: feat(ai): add OAuth for MCP clients + refactor to new package

  This change replaces

  ```ts
  import { experimental_createMCPClient } from "ai";
  import { Experimental_StdioMCPTransport } from "ai/mcp-stdio";
  ```

  with

  ```ts
  import { experimental_createMCPClient } from "@ai-sdk/mcp";
  import { Experimental_StdioMCPTransport } from "@ai-sdk/mcp/mcp-stdio";
  ```
