Vercel OSS Registry MCP
An MCP server that lets you search every project in the Vercel Open Source Program: 138 projects across 5 cohorts, from Spring 2025 to Spring 2026. Each project has its GitHub link, description, topics (usable as keywords), language, license, stars and activity.
It is built on the MCP TypeScript SDK v2 (@modelcontextprotocol/server, spec 2026-07-28).
Tools (progressive disclosure)
Resources:
vercel-oss://projects/{owner}/{repo}: one project as Markdown, with owner/repo completion.
vercel-oss://facets
vercel-oss://catalog: the full JSON.
All tools are read-only and idempotent and declare an outputSchema. List and read results include cache hints with a 1-day TTL.
Connect
The hosted endpoint uses Streamable HTTP and needs no auth:
Cursor / VS Code / other clients: { "mcpServers": { "vercel-oss": { "url": "https://vercel-oss.vril.dev/mcp" } } }
The server is listed in the MCP Registry as io.github.VrilLabs/vercel-oss-registry.
Develop
Claude Code: claude mcp add vercel-oss -- npx tsx /path/to/src/stdio.ts
HTTP endpoints: /mcp, /health, /mcp/server-card (Server Card, SEP-2127).
Catalog
data/catalog.json is built ahead of time, so the server makes no GitHub calls at runtime:
The builder refuses to write the file if it parses fewer entries than there are unique repo links on the page. A weekly GitHub Action rebuilds the catalog and opens a PR.
Repos that no longer resolve or have changed hands (warning field) are hidden from search by default. Pass includeUnavailable: true to show them.
Deploy
The app deploys to Vercel with zero config. src/index.ts default-exports a Hono app, which Vercel runs as a single Node.js function on Fluid compute (vercel.json sets framework: "hono"). The function only accepts requests whose Host header matches vercel-oss.vril.dev or one of the Vercel deployment URLs. Override the list with ALLOWED_HOSTS (comma-separated).
Pushing a v* tag publishes server.json to the MCP Registry through GitHub OIDC (.github/workflows/publish-mcp.yml).