Skip to content
Back to blog

xmcp vs Vercel mcp-handler: Which MCP Solution Is Right for You?

A focused comparison of xmcp and Vercel's mcp-handler — two very different takes on MCP in TypeScript. One is a standalone framework; the other bolts MCP onto an existing Next.js or Nuxt app.

xmcp and mcp-handler can both expose MCP tools from an existing application. The main choice is how you want to organize and build those tools, rather than whether your server must be a separate service.

Compare the integration model

Concernxmcpmcp-handler
OrganizationTool, resource, and prompt filesRegistration inside an HTTP handler
Existing applicationFramework adaptersFetch-compatible handler
Standalone processHTTP and STDIO buildsApplication supplies the HTTP host
AuthenticationProvider integrations and middlewareBearer-token verification helpers

The current mcp-handler documentation describes v2, installed as mcp-handler. Its registration and transport options differ from v1; use the migration guide instead of old @vercel/mcp-adapter or SSE/Redis snippets.

Choose xmcp for file-based organization

A tool can be a self-contained TypeScript file:

src/tools/greet.ts

Use the Next.js adapter when tools belong with your web application, or create a standalone project when it needs its own deployment. The same file-based workflow applies to resources and prompts.

Choose around ownership and deployment

A request-handler approach fits teams that want MCP registration next to existing HTTP routing. File discovery fits teams that want separate modules for each capability and a compiler-managed build. In either case, keep authorization and business logic in code you can test independently.

Test an authenticated tool with your target client before choosing. Verify denied requests, input validation, and production hosting behavior. Neither framework removes the need to configure identity providers or protect access to your data.

Start with xmcp templates, the integration catalog, or the full framework comparison.

One framework to rule them all