README.md
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:
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.jsonand adjust max duration to 800 if you using a Vercel Pro or Enterprise account - Deploy the MCP template
Local dev
- Run
vercel devfor 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.
node scripts/test-client.mjs https://mcp-on-vercel.vercel.app
Tools 2
roll_diceRolls an N-sided die with a minimum of 2 sides.get_weatherGets current weather data for a location using latitude, longitude, and city name.Try it
→Roll a 20-sided die for my D&D game.
→What is the current weather in San Francisco using latitude 37.77 and longitude -122.41?
→Can you roll a 6-sided die for me?