
vercel-oss-registry
io.github.VrilLabs/vercel-oss-registry
Search all 138 projects funded by the Vercel Open Source Program: repos, descriptions, topics.
Documentation
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)
| Tool | Returns |
|---|---|
search_projects | Short results (id, name, one-line summary, top 5 topics, stars). Supports fuzzy and prefix full-text search, filters by topic, language, cohort and minimum stars, sorting, and pagination. |
get_project | The full record for 1–10 ids, plus resource_links. Unknown ids come back with "did you mean" suggestions. |
list_facets | The valid topic, language and cohort values, with counts. |
Resources:
vercel-oss://projects/{owner}/{repo}: one project as Markdown, with owner/repo completion.vercel-oss://facetsvercel-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:
https://vercel-oss.vril.dev/mcp
claude mcp add --transport http vercel-oss https://vercel-oss.vril.dev/mcp
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
pnpm install
pnpm stdio # stdio transport
pnpm dev # Streamable HTTP on http://127.0.0.1:3000/mcp
pnpm inspect # MCP Inspector
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:
pnpm catalog # scrape vercel.com/open-source-program + GitHub GraphQL enrichment
pnpm catalog:check # exit 1 if the page lists repos missing from the catalog
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).
No installation packages available.