# Mcp On Vercel

> Boilerplate for running Remote MCP Servers on FaaS Providers

- **Type:** MCP server
- **Install:** `agentstack add mcp-sdiehl-mcp-on-vercel`
- **Verified:** Pending review
- **Seller:** [sdiehl](https://agentstack.voostack.com/s/sdiehl)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [sdiehl](https://github.com/sdiehl)
- **Source:** https://github.com/sdiehl/mcp-on-vercel
- **Website:** https://www.stephendiehl.com/posts/remote_mcp_servers/

## Install

```sh
agentstack add mcp-sdiehl-mcp-on-vercel
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Remote Serverless MCP Servers

You want to run a remote MCP server, but you don't want to host or pay for a server. Well you're in luck, you can use the Vercel Hobby Tier to run it for free.

This is an adapter library that provides a stateless Python MCP server that runs on [Vercel Functions](https://vercel.com/docs/functions), enabling serverless deployment of MCP tools as edge functions with self-hosting installers. 

## Prerequisites

[Fork](https://github.com/sdiehl/mcp-on-vercel/fork) this repo and [connect it](https://vercel.com/docs/getting-started-with-vercel/template#connect-your-git-provider) to your Vercel account. Once it's deployed get the URL
(`your-domain.vercel.app`).

If you don't have uv installed, install it from astral:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Then, install the MCP server using the self-hosted installer:

```bash
uv run https://your-domain.vercel.app/install.py
```

And we're done. This automatically:

- Configures Claude Desktop and Cursor to use the MCP server
- Uses the bridge script served directly from the server
- No downloads or local files needed

Go to your client and type something stupid like "Use MCP to get the server time" and it should use the remote server.

## Authentication (Optional)

The server supports optional API key authentication to restrict access. To enable authentication:

1. **Server-side**: Set the `MCP_API_KEY` environment variable in your Vercel deployment
2. **Client-side**: The installer will prompt for an API key during setup

You can set the API key in your `vercel.json` file or in the Vercel dashboard:

```json
{
  "env": {
    "MCP_API_KEY": "your-secret-key-here"
  }
}
```

When an API key is configured on the server, all MCP requests must include the key in the `X-API-Key` header. The bridge script automatically handles this when the `MCP_API_KEY` environment variable is set in the client configuration.

## Local Development

```bash
uv sync
vercel dev
```

## Deploy

You just push to Github and it should just work.

Or manually deploy:

```bash
vercel --prod
```

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sdiehl](https://github.com/sdiehl)
- **Source:** [sdiehl/mcp-on-vercel](https://github.com/sdiehl/mcp-on-vercel)
- **License:** Apache-2.0
- **Homepage:** https://www.stephendiehl.com/posts/remote_mcp_servers/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-sdiehl-mcp-on-vercel
- Seller: https://agentstack.voostack.com/s/sdiehl
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.