Repository avatar
Search & Data Extraction
v0.1.0
active

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)

ToolReturns
search_projectsShort 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_projectThe full record for 1–10 ids, plus resource_links. Unknown ids come back with "did you mean" suggestions.
list_facetsThe valid topic, language and cohort values, with counts.

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:

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.

Remote