OpenAPI Clients

Type-safe auto-generated API clients for various APIs

A collection of type-safe OpenAPI clients automatically generated from their respective OpenAPI specifications. These clients are updated daily to stay in sync with upstream API changes.

Available Clients

Package	Description	npm
vercel-api-js	Vercel Platform API client with MCP support
v0-api	Vercel v0 API client with MCP support
cloudflare-api-js	Cloudflare API client
netlify-api	Netlify API client
zoom-api-js	Zoom API client
keycloak-api	Keycloak Admin & Account API client
nuki-api-js	Nuki Smart Lock API client
litellm-api	LiteLLM API client

Installation

npm

npm install vercel-api-js

Replace vercel-api-js with the package name for your desired API client.

Usage

Basic Usage

All clients export typed fetchers for each API endpoint:

import { Fetchers } from "vercel-api-js";

// Configure the client
const client = Fetchers.createClient({
  baseUrl: "https://api.vercel.com",
  headers: {
    Authorization: `Bearer ${process.env.VERCEL_TOKEN}`,
  },
});

// Make type-safe API calls
const projects = await client.listProjects();

With MCP (Model Context Protocol)

Some clients (vercel-api-js, v0-api) include MCP server support for AI assistants:

import { initMcpTools } from "vercel-api-js/mcp";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

const server = new McpServer({ name: "vercel" });

initMcpTools(server, {
  baseUrl: "https://api.vercel.com",
  headers: {
    Authorization: `Bearer ${process.env.VERCEL_TOKEN}`,
  },
});

Type Exports

Each client exports TypeScript types for all API schemas:

import type { Types, Schemas } from "vercel-api-js";

// Use TypeScript types
type Project = Types.Project;

// Use Zod schemas for validation
const projectSchema = Schemas.project;

Features

• Type-Safe - Full TypeScript support with auto-generated types
• Zod Schemas - Runtime validation with Zod schemas for all API types
• MCP Support - Model Context Protocol integration for AI assistants (select packages)
• Auto-Updated - Daily regeneration from upstream OpenAPI specs
• Tree-Shakeable - Only import what you need

How It Works

These clients are generated using Kubb from OpenAPI specifications. The generation process:

1. Fetches the latest OpenAPI spec from the API provider
2. Cleans and normalizes operation IDs and schemas
3. Generates TypeScript types, Zod schemas, and fetch clients
4. Creates MCP tool definitions for supported APIs

Updates are automated via GitHub Actions that run hourly to check for spec changes.