Run an MCP Server on Vercel

Usage

Update api/server.ts with your tools, prompts, and resources following the MCP TypeScript SDK documentation.

There is also a Next.js version of this template

MCP Client Integration

When adding this server to an MCP client application, use your deployment URL followed by /mcp:

1
https://your-deployment-url.vercel.app/mcp

Example Tools

The template includes two example tools to get you started:

• roll_dice - Rolls an N-sided die (minimum 2 sides)
• get_weather - Gets current weather data (via an API) for a location using latitude, longitude, and city name

These tools demonstrate basic functionality and API integration patterns. Replace them with your own tools.

Notes for running on Vercel

• Make sure you have Fluid compute enabled for efficient execution
• After enabling Fluid compute, open vercel.json and adjust max duration to 800 if you using a Vercel Pro or Enterprise account
• Deploy the MCP template

Local dev

• Run vercel dev for local development
• Alternatively, integrate the system into the server framework of your choice.

Sample Client

script/test-client.mjs contains a sample client to try invocations.

1
node scripts/test-client.mjs https://mcp-on-vercel.vercel.app