# xmcp Changelog

> New features, improvements, and fixes in every stable xmcp release.

## v1.4.0

October 2, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%401.4.0)

### Minor Changes

- 7a3097c: Add optional icons, tags, and enabled metadata for tools, prompts, resources, and resource templates. Expose tags under `_meta["xmcp/tags"]` and omit disabled components and their generated UI resources from registration, listings, and direct requests.

## v1.3.0

October 2, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%401.3.0)

### Minor Changes

- c844b6d: Add `image`, `audio`, and `embeddedResource` content helpers, available from `xmcp` and `xmcp/cloudflare`. Add Node-only file-reading variants under `xmcp/node`.
- 1656cdc: Support a named `complete` export on resource template files for URI argument suggestions, including asynchronous and context-dependent completion callbacks. Export `ResourceCompletions` for typed callback maps.
- a1f4d67: Add a TanStack Start adapter for React applications on Node.js and Cloudflare Workers, with ESM output, stateless request handling, and automatic setup through init-xmcp.

## v1.2.0

October 2, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%401.2.0)

### Minor Changes

- 826c21b: Extend MCP middleware to prompts, resource reads, completion, and component listings, sharing request context across each operation. Check `ctx.method` before accessing operation-specific parameters in existing tool middleware.
- 176ac1d: Support a named `mcp` middleware export in `src/middleware.ts` for tool calls across HTTP, STDIO, and Node adapters. Middleware can inspect validated arguments, share request-local values with tools, transform results, or short-circuit execution.
- ae2658a: Allow prompt handlers to return message arrays or full prompt results, preserving message roles, order, descriptions, and metadata. Export the `PromptMessage` and `GetPromptResult` types for typed prompt handlers.
- 0ca4841: Add request-local `set`/`get` values and `progress`/`log` helpers to `getRequestContext()`. Progress is optional without a request token, and logging respects the SDK's capability and level checks.
- b5ca4c8: Add `getRequestContext()` for read-only access to client identity, HTTP request details, and the cancellation signal from tool handlers and their async helpers.

## v1.1.3

September 3, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%401.1.3)

### Patch Changes

- e2c4a5b: Fix Vercel deployments logging `Vercel Runtime Timeout Error: Task timed out after 300 seconds` on every cold start. The build copied `dist/http.js` into the function, and that entry starts a server of its own and exports nothing. Vercel's Node launcher fell back to serving the port the entry listened on, and the listening socket kept the instance's event loop alive: the invocation that booted the server never settled and was killed once the function's maximum duration was reached, even though the response had already been sent in milliseconds. The instance died with it, so the next request cold started and repeated the cycle.

  `--vercel` builds now use a runtime that exports a request handler and never listens, so the platform owns the server and each invocation ends with its response. Standalone (`dist/http.js`), adapter, and Cloudflare builds are unchanged.

## v1.1.2

August 29, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%401.1.2)

No release notes provided.

## v1.1.1

August 24, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%401.1.1)

### Patch Changes

- 01faeb8: Fix `xmcp build --cf` / `xmcp dev --cf` failing with `Module not found: Can't resolve '.../node_modules/xmcp/src/runtime/platforms/cloudflare/worker.ts'` since `src/` stopped shipping in the published package (0.7.1). The Cloudflare worker runtime is now prebuilt into `dist/runtime/cloudflare-worker.js` like the other runtimes, and the compiler uses that artifact as the `--cf` entry instead of bundling xmcp's TypeScript source from `node_modules`.

## v1.1.0

August 22, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%401.1.0)

### Minor Changes

- bbe742e: Add `extra.sample()` so tool handlers can request LLM completions from the connected client via MCP sampling (`sampling/createMessage`), mirroring `extra.elicit()`. Supports text/image/audio messages, `systemPrompt`, `maxTokens`, `modelPreferences`, `temperature`, `stopSequences`, `includeContext`, and `metadata`, and exports the `SampleRequest`/`SampleResult` types. The `tools`/`toolChoice` sampling loop and task-augmented sampling are rejected with a clear error until the client tool-call flow is wired.

## v1.0.0

August 22, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%401.0.0)

### Patch Changes

- 10bdd57: Upgrade to MCP protocol revision 2026-07-28 via the TypeScript SDK v2 (`@modelcontextprotocol/server` and `@modelcontextprotocol/client` replace the v1 `@modelcontextprotocol/sdk` monolith as optional peers, bundled into the runtime).
  - All transports (HTTP, STDIO, Cloudflare Workers, Next.js/Express/Fastify/NestJS adapters) serve both protocol generations: 2026-07-28 envelope requests (including `server/discover`, `resultType`, cacheable list results) natively, and 2025-era clients through the SDK's stateless fallback. HTTP stays strictly stateless — a fresh server per request on both paths.
  - New multi round-trip input API for tools: `inputRequired`, `acceptedContent`, `inputResponse`, and `createRequestStateCodec` are re-exported from `xmcp`, and tool extras expose `inputResponses`/`requestState`. Tools returning `inputRequired(...)` serve both eras (the legacy shim converts to real elicitation for 2025 clients). `extra.elicit()` keeps working on 2025-era connections and throws a descriptive error on 2026-07-28 requests.
  - Tool/prompt/resource schemas are registered through the Standard Schema interface with per-field conversion, keeping the `zod ^3.25.76 || ^4.0.0` peer range working without cross-instance zod composition.
  - Default CORS `allowedHeaders` now include the `Mcp-Method` and `Mcp-Name` headers required on Streamable HTTP POSTs by 2026-07-28.
  - Client helpers (`createHTTPClient`, `createSTDIOClient`) negotiate the protocol version automatically (`server/discover` probe with fallback to `initialize`).
  - Server bundles remain single-file (the SDK's lazy validator imports are inlined by the compiler and the runtime prebuild).
  - Fix: the Express adapter no longer references never-injected CORS globals; it reads the injected `HTTP_CORS_CONFIG` like the other adapters.

## v0.8.0

August 20, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%400.8.0)

### Changes

- Split the development compiler into `@xmcp-dev/compiler`. Existing `xmcp dev`,
  `xmcp build`, and `xmcp create` scripts continue to work through a small shim,
  but projects must install the matching compiler version as a development
  dependency: `npm i -D @xmcp-dev/compiler@0.8.0`.
- Production installs no longer include Rspack or TypeScript. Built HTTP and
  stdio artifacts remain self-contained and can run without `node_modules`.
- Added the `xmcp/config` export so compiler validation uses the config schema
  from the installed runtime package.
- Removed the duplicate runtime embedded in the CLI and removed compiler-only
  schema and Chalk code from the HTTP runtime.

| Metric | Improvement |
|---|---:|
| Runtime tarball | **51.08% smaller** |
| Production install | **89.99% smaller** |
| Production dependencies | **169 → 2** |
| Development install | **15.81% smaller** |
| Generated HTTP artifact | **1.07% smaller** |

Measures the split independently with the same HTTP fixture on xmcp@0.7.1 and xmcp@0.8.0: the production install falls 89.99% (101.12 MiB to 10.12 MiB), while the generated HTTP artifact remains nearly flat (-1.07%).


## v0.7.1

August 16, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%400.7.1)

### Patch Changes

- e3a9f60: Stop shipping `src` in the published package. Every entry point in `main`,
  `types`, `bin`, `exports`, and `typesVersions` resolves into `dist`, and no
  source maps reference `src`, so the directory was dead weight in the tarball:
  223 files down to 71.

## v0.7.0

August 16, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/xmcp%400.7.0)

### Minor Changes

- d5c0f46: Add a Fastify adapter, serve the MCP Server Card at
  `/.well-known/mcp/server-card.json`, fix stateless HTTP handling of repeated
  `clientInfo` headers, and update dependencies to resolve known security
  advisories.

## v0.6.13

June 22, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.13)

## What's Changed
* Security updates by @0xKoller in https://github.com/basementstudio/xmcp/pull/595


**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.12...v0.6.13

## v0.6.12

June 17, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.12)

## What's Changed
* chore: update @xmcp-dev/commet for @commet/node v5.0 by @decker-dev in https://github.com/basementstudio/xmcp/pull/582
* docs: add guide for rolling out xmcp servers to a team by @saif-at-scalekit in https://github.com/basementstudio/xmcp/pull/590
* x402 blog post by @0xKoller in https://github.com/basementstudio/xmcp/pull/579
* security updates


**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.11...v0.6.12

## v0.6.11

June 3, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.11)

## What's Changed
* feat: add @xmcp-dev/scalekit plugin for OAuth 2.1 authentication by @saif-at-scalekit in https://github.com/basementstudio/xmcp/pull/578
* Examples/Templates section by @0xKoller in https://github.com/basementstudio/xmcp/pull/512

## New Contributors
* @saif-at-scalekit made their first contribution in https://github.com/basementstudio/xmcp/pull/578

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.10...v0.6.11

## v0.6.10

May 15, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.10)

## What's Changed
* Up-to-date canary to main by @0xKoller in https://github.com/basementstudio/xmcp/pull/567
* feat(adapters): add Fastify adapter by @wessmeister in https://github.com/basementstudio/xmcp/pull/563
* v0.6.10 by @0xKoller in https://github.com/basementstudio/xmcp/pull/573

## New Contributors
* @wessmeister made their first contribution in https://github.com/basementstudio/xmcp/pull/563

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.9...v0.6.10

## v0.6.9

April 22, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.9)

Hotfix: remove session fallback for stateful mode

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.8...v0.6.9

## v0.6.8

April 22, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.8)

## What's Changed
* Add instructions to server info by @0xKoller in https://github.com/basementstudio/xmcp/pull/519
* Expose stdio clientInfo in tool extra context by @mhoritani in https://github.com/basementstudio/xmcp/pull/564
* Mcp app fixes by @0xKoller in https://github.com/basementstudio/xmcp/pull/565


**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.7...v0.6.8

## v0.6.7

April 16, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.7)

## What's Changed
* feat: improve error handling for empty or malformed tool files by @FiammaMuscari in https://github.com/basementstudio/xmcp/pull/528
* Tool registration mutates by @0xKoller in https://github.com/basementstudio/xmcp/pull/531
* Feat/ambient injected globals dts by @lioarce01 in https://github.com/basementstudio/xmcp/pull/537
* feat(xmcp): add elicitation helper for tool handlers by @FiammaMuscari in https://github.com/basementstudio/xmcp/pull/543
* fix(xmcp): align prompt and resource loader startup behavior by @FiammaMuscari in https://github.com/basementstudio/xmcp/pull/538
* feat(cli): add create scaffolding command by @FiammaMuscari in https://github.com/basementstudio/xmcp/pull/554
* xmcp/headers and nextjs bug fix by @0xKoller in https://github.com/basementstudio/xmcp/pull/552
* Homepage testimonials section by @0xKoller in https://github.com/basementstudio/xmcp/pull/544
* feat: add @xmcp-dev/commet plugin for subscription-aware billing by @decker-dev in https://github.com/basementstudio/xmcp/pull/546
* Expose initialize clientInfo in tool handler extra context by @mhoritani in https://github.com/basementstudio/xmcp/pull/559

## New Contributors
* @FiammaMuscari made their first contribution in https://github.com/basementstudio/xmcp/pull/528
* @lioarce01 made their first contribution in https://github.com/basementstudio/xmcp/pull/537
* @decker-dev made their first contribution in https://github.com/basementstudio/xmcp/pull/546
* @mhoritani made their first contribution in https://github.com/basementstudio/xmcp/pull/559

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.6...v0.6.7

## v0.6.6

April 12, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.6)

## What's Changed

* Adding icon support to the xmcp config xmcp by @0xKoller in https://github.com/basementstudio/xmcp/pull/509
* Output Schema by @0xKoller in https://github.com/basementstudio/xmcp/pull/498
* update to nextjs16 by @0xKoller in https://github.com/basementstudio/xmcp/pull/511
* Suppress stdio output syncasync flows by @0xKoller in https://github.com/basementstudio/xmcp/pull/503
* Restart server on file deletion by @0xKoller in https://github.com/basementstudio/xmcp/pull/502
* Security depes update and overrides moved to root by @0xKoller in https://github.com/basementstudio/xmcp/pull/514
* smithery docs update by @0xKoller in https://github.com/basementstudio/xmcp/pull/515
* Allow a trailing slash in the Auth0 audience by @Sambego in https://github.com/basementstudio/xmcp/pull/520

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.5...v0.6.6

## v0.6.5

March 2, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.5)

## What's Changed
* Update react-mdx dependecy by @0xKoller in https://github.com/basementstudio/xmcp/pull/494
* Update og for examples by @0xKoller in https://github.com/basementstudio/xmcp/pull/496
* Multiple security updates by @0xKoller in https://github.com/basementstudio/xmcp/pull/497
* Remove OpenAI apps and leave only gpt apps metadata by @0xKoller in https://github.com/basementstudio/xmcp/pull/493
* Add summary build log by @julideangelis in https://github.com/basementstudio/xmcp/pull/501
* Skip install by @0xKoller in https://github.com/basementstudio/xmcp/pull/504
* v0.6.5 by @valebearzotti in https://github.com/basementstudio/xmcp/pull/505

## New Contributors
* @julideangelis made their first contribution in https://github.com/basementstudio/xmcp/pull/501

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.4...v0.6.5

## v0.6.4

February 4, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.4)

## What's Changed
* fix create-xmcp-app cloudflare flag by @valebearzotti in https://github.com/basementstudio/xmcp/pull/490


**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.3...v0.6.4

## v0.6.3

February 4, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.3)

## Core Changes
* Cloudflare Support by @0xKoller in https://github.com/basementstudio/xmcp/pull/478
* compatible middlewares for cloudflare + custom module by @valebearzotti in https://github.com/basementstudio/xmcp/pull/483
* clouflare cli starter by @valebearzotti in https://github.com/basementstudio/xmcp/pull/486
* update cloudflare dev to rebuild dev server by @valebearzotti in https://github.com/basementstudio/xmcp/pull/487


**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.2...v0.6.3

## v0.6.2

January 28, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.2)

## Core Changes
- Release to address security issues

## v0.6.1

January 26, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.1)

## Core Changes
* Change the resource parameter for the oauth-authorization-server from baseurl to audience by @Sambego in https://github.com/basementstudio/xmcp/pull/469
* fix(init-xmcp): set skipped paths to false instead of omitting them by @sgalanb in https://github.com/basementstudio/xmcp/pull/470
* Adapter nest by @0xKoller in https://github.com/basementstudio/xmcp/pull/468
* fix: skip Vercel output build when using adapter by @julianbenegas in https://github.com/basementstudio/xmcp/pull/471
* Mcp apps bug html doesnt render by @0xKoller in https://github.com/basementstudio/xmcp/pull/472
* Use npx xmcp create to scaffold new tools, resources, prompts & widgets by @valebearzotti in https://github.com/basementstudio/xmcp/pull/473

## New Contributors
* @Sambego made their first contribution in https://github.com/basementstudio/xmcp/pull/469
* @sgalanb made their first contribution in https://github.com/basementstudio/xmcp/pull/470
* @julianbenegas made their first contribution in https://github.com/basementstudio/xmcp/pull/471

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.6.0...v0.6.1

## v0.6.0

January 16, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.6.0)

## Core Changes
* Remove experimental OAuth configuration & proxy
* Auth0 plugin

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.9...v0.6.0

## v0.5.9

January 15, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.9)

## Core changes
* hot fix express types version and bundle x402/core

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.8...v0.5.9

## v0.5.8

January 15, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.8)

## Core Changes
* @xmcp-dev/workos plugin
* @xmcp-dev/clerk plugin
* support for stateless auth
* x402 middleware and paid wrapper
* bug fixing & improvements

## Contributors
* @valebearzotti 
* @fveiraswww 
* @0xKoller 

## New Contributors
* @cranberyxl made their first contribution in https://github.com/basementstudio/xmcp/pull/424

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.7...v0.5.8

## v0.5.7

January 6, 2026 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.7)

## Core Changes
* feat: introducing customHome config option
* automatically setup path alias on init-xmcp
* feat: skip type check on nextjs adapter mode
* feat: update adapter mode tool generated syntax
* fix: include tsx files in tsconfig for default templates
* add CSS module type declarations for zero-config ts support
* feat: example initialization via cli
* add globals.css auto-detection

## Contributors
@valebearzotti 
@fveiraswww 
@mdottavio 

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.6...v0.5.7

## v0.5.6

December 23, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.6)

## What's Changed
* Improve create-xmcp-app CLI - prompt with templates
* add openAI apps challenge route autogenerated
* fix: tool `InferSchema` with compatible zod versions

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.5...v0.5.6

## v0.5.5

December 22, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.5)

## Core Changes
* Integrate MCP apps protocol
* update all React & Next dependencies
* Replace CDN externals with direct bundling
* replace individual inputs with toggle selector for init-xmcp
* Support Zod v4 - backwards compatible with v3
* Tailwind and CSS loaders to React tools
* always preserve mcp-protocol-version and mcp-session-id headers
* bump better-auth to v1.4.5 - address security issues

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.4...v0.5.5

## v0.5.4

December 10, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.4)

## Core Changes
* Add support for STDIO clients connections
* Type Client generation
* add structuredContent in Apps SDK handlers
* CORS middleware add preflight flag
* update xmcp and root dependencies

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.3...v0.5.4

## v0.5.3

December 3, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.3)

## Core Changes
* Optimize react tools compilation and hashing
* Create remote MCP clients and generate schemas
* @xmcp-dev/cli

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.1...v0.5.3

## v0.5.2

December 3, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.2)

## Core Changes
* Optimize react tools compilation and hashing
* Create remote MCP clients and generate schemas
* @xmcp-dev/cli

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.1...v0.5.2

## v0.5.1

November 25, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.1)

## Core Changes
* hot fix: compiler callback store breaking context on node version > 22
* add opt-in telemetry tracking

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.5.0...v0.5.1

## v0.5.0

November 19, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.5.0)

## Core Changes
- Improve runtime file selection - smaller output size
- Skip type checking config
- Reduce download size by 30%
- Swap webpack compiler with rspack - improve compilation times
- Rework config workflow
- React code transpilation with rspack
- Update template UI

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.4.0...v0.5.0

## v0.4.0

November 4, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.4.0)

## Core Changes

- Dev mode and import generation optimizations
- Remove experimental flag - support React by default
- Clean up legacy SSR code
- Deprecate --ui and --gpt flags
- Fix Type checking on dev/build
- Bug fixing and improvements

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.3.6...v0.4.0

## v0.3.6

October 29, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.3.6)

## Core changes
* Fix/lock swc core version
* Fix/react jsx runtime error
* Fix node modules resolution
* Abstract Next.js adapter
* Fix client side react rendering

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.3.5...v0.3.6

## v0.3.5

October 23, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.3.5)

## Core Changes
- Add support for Structured Content output
- Complete OpenAI widget metadata & handling
- Experimental SSR + Hydration feature. Support returning React components in tool handlers.
- Fix toggle off paths from config on unselection (create-xmcp-app)
- bug fixing & improvements

## New Contributors
* @fedealvarezcampos made their first contribution
* @fveiraswww made their first contribution

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.3.4...v0.3.5

## v0.3.4

October 16, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.3.4)

## What's Changed
Update `create-xmcp-app --gpt` CLI project scaffolding

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.3.3...v0.3.4

## v0.3.3

October 16, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.3.3)

## What's Changed
- Support for tools returning UI & automatically handling resource creation & injection.
- Simpler Apps SDK DX

## v0.3.2

October 10, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.3.2)

## What's Changed
* Support for rendering GPT apps UI
* Bug fixing & improvements

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.3.1...v0.3.2

## v0.3.1

September 26, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.3.1)

## What's Changed
* Support xmcp handler to return on any route
* Bun package manager version
* Polar SH integration

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.3.0...v0.3.1

## v0.3.0

September 16, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.3.0)

## What's Changed
- Added support for resources
- Added option to customize initialized components (create-xmcp-app)
- Added CLI support for resources
- Next.js adapter - Improved support to work on any route

## Contributors
@valebearzotti 

## New Contributors
@FranFigueroa 

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.2.1...v0.3.0

## v0.2.1

September 10, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.2.1)

## What's Changed
* import { tools } compatible with the AI SDK
* Adds autocomplete to tools registry
* Fix generate-config in init-xmcp to output valid paths object

## Misc
* Added xmcp <> AI SDK example
* Added xmcp <> MCP UI example
* Update docs to reflect prompts
* Update docs to reflect Cursor and Claude Desktop connections

## New Contributors
* @joelachance contributed on the AI SDK tools POC

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.2.0...v0.2.1

## v0.2.0

September 3, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.2.0)

# Core changes

## What's Changed
- Support for prompts
- Upgrade server registration to newer API
- Tools / prompts return content to fail gracefully and indicate errors
- Prompts path handling in xmcp.config.ts
- Fix: support comments and trailing commas in tsconfig.json
- 
**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.13...v0.2

## v0.1.13

August 22, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.13)

## Patch Changes
- Add template link to xmcp.dev

## v0.1.12

August 22, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.12)

## Patch Changes

- Fix copying full URL on template

## v0.1.11

August 22, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.11)

- Template configuration
- Template landing redesign
- Middleware type naming consistency

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.10...v0.1.11

## v0.1.10

August 15, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.10)

## Core Changes
- Add Better Auth example using xmcpHandler
- Change transport selection on `create-xmcp-app` to be single select
- Compiled message on rebuilt
- Zero-configuration on Vercel setup

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.9...v0.1.10

## v0.1.9

August 12, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.9)

## What's Changed

Update vercel build output
Ship `@xmcp-dev/better-auth` integration
Improvements & minor bug fixing

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.8...v0.1.9

## v0.1.8

August 6, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.8)

## Core changes
* Add `ToolExtraArguments` arguments type + usage example
* remove useLocalXmcp flag from cli
* add nvmrc config
* support for Bun package manager
* HTTP transport to use dynamic port allocation & normalize config usage
* Shorten string/number tool response syntax

## Misc
* Contribution Guidelines setup

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.7...v0.1.8

## v0.1.7

July 22, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.7)

### Core changes

- Host config for HTTP servers
- Default CORS configuration
- Debug flag for STDIO logs suppression to ensure client compatibility
- withAuth wrapper for xmcpHandler

& bug fixing & improvements

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.6...v0.1.7

## v0.1.6

July 16, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.6)

## What's Changed
* Fixed issue with default metadata


**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.5...v0.1.6

## v0.1.5

July 16, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.5)

## What's Changed
* Update the required exports for a tool file to work. Now it only requires the default export


**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.4...v0.1.5

## v0.1.4

July 12, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.4)

## What's Changed

### create-xmcp-app
- Fixed starter to include bin on the package.json if stdio mode is enabled

### xmcp
- Add webpack plugin to add shebang to stdio.js

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.3...v0.1.4

## v0.1.3

July 7, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.3)

No release notes provided.

## v0.1.2

July 7, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.2)

- Import map paths on windows


**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.1...v0.1.2

## v0.1.1

July 7, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.1)

- Updated starter cli
- Updates on docs and homepage

**Full Changelog**: https://github.com/basementstudio/xmcp/compare/v0.1.0...v0.1.1

## v0.1.0

July 7, 2025 · [View on GitHub](https://github.com/basementstudio/xmcp/releases/tag/v0.1.0)

# The TypeScript MCP Framework

`xmcp` is a framework for building and shipping MCP applications with TypeScript. Designed with DX in mind, it streamlines development and lowers the barrier to entry for anyone looking to create and deploy powerful tools on top of the Model Context Protocol ecosystem.

## Features

⊹ **File System Routing** - Tools are auto-registered from a `tools` directory\
⊹ **Hot Reloading** - Instant development feedback\
⊹ **Middlewares** - Toolkit for shipping authentication and custom middlewares\
⊹ **Extensible Configuration** - Customizable configuration for your MCP server\
⊹ **Deploy Anywhere** - Flexible deployment across any platform\
⊹ **Vercel Support** - Deploy-ready for Vercel out of the box