Quickstart — Lightspeed

---

ZERO TO PRODUCTION

Scaffold. Build. Deploy.
The framework for the AI era.

From an empty directory to a live MCP server on Vinkius Cloud in under 40 seconds — with DLP, kill switch, and audit trail. You define the architecture. Your AI agent writes the code.

TELL YOUR AI AGENT

"Scaffold a Vurb MCP server with a health tool, Presenter, and PII redaction — then deploy it to Vinkius Cloud."

Open in Claude Open in ChatGPT

---

AI-FIRST DEVELOPMENT

You are the architect.
The AI writes the code.

Vurb.ts ships a SKILL.md — a machine-readable architectural contract your AI coding agent can ingest. Point Cursor, Claude Code, Copilot, or Windsurf at the spec and prompt what you need.

What you say

"Create an MCP server for invoice management with Presenters, PII redaction on customer_ssn, and middleware auth."

What the AI produces

Idiomatic Vurb.ts — correct file-based routing, typed Presenters, .redactPII() paths, middleware chains — on the first pass.

The SKILL.md teaches the AI the entire framework architecture — MVA pattern, Presenter rules, middleware composition, file conventions. Your job is to define what your server does. The AI's job is to write the code that does it. Works with Cursor, Claude Code, GitHub Copilot, Windsurf, and Cline.

TIP

Explore more at agentskills.io — the Agent Skills ecosystem for distributing domain expertise to AI agents.

---

Prerequisites

Node.js 18+ required.

npm install @vurb/core @modelcontextprotocol/sdk zod

Already using a project?

If you're adding Vurb.ts to an existing Node.js project — skip to Building Tools.

From Zero to Live

Four commands. Under 40 seconds. Your MCP server on Vinkius Cloud's global edge.

01

Scaffold

terminal

vurb create my-server

02

Develop locally

terminal

cd my-server
vurb dev

HMR — edit any tool, middleware, or Presenter and the server reloads instantly.

03

Test

terminal

npm test

In-memory harness — no transport, no network. All tests pass from scaffold.

04

Deploy to Vinkius Cloud

terminal

vurb deploy

Global edge. DLP redaction, V8 sandbox, rate limiting, kill switch, audit trail — all built in. Share the connection token with any MCP client.

That's it. Four commands. Your server is live. Skip the wizard with --yes for defaults:

vurb create my-api --vector prisma --transport sse --yes

Pro-Tip: --vector prisma is the fastest way to bridge Prisma to MCP. The Presenter's schema strips internal columns before they ever reach the LLM.

What Just Happened

When you ran vurb deploy, Vinkius Cloud activated 8 security layers — automatically:

🛡️

DLP Engine

🔒

V8 Sandbox

⚡

Rate Limiter

🚨

Kill Switch

📋

Audit Trail

🧱

Egress Firewall

🔄

Circuit Breaker

🔐

Token Auth

TIP

Vurb blocks PII locally by default. Need compliance proof (SOC2/GDPR/HIPAA)? Connect to Vinkius Cloud for tamper-proof Audit Logs →

Zero-Friction AI Integration

vurb create auto-injects SKILL.md into your IDE's rule files — .cursorrules, .windsurfrules, .clinerules. The moment you scaffold, your IDE becomes a framework-expert architect. No manual setup.

---

What You Get

project structure

my-server/
├── src/
│   ├── vurb.ts            # initVurb<AppContext>()
│   ├── context.ts           # AppContext type + factory
│   ├── server.ts            # Bootstrap with autoDiscover
│   ├── tools/
│   │   └── system/
│   │       ├── health.ts    # Health check with Presenter
│   │       └── echo.ts      # Connectivity test
│   ├── presenters/
│   │   └── SystemPresenter.ts
│   ├── prompts/
│   │   └── greet.ts
│   └── middleware/
│       └── auth.ts
├── tests/
│   ├── setup.ts
│   └── system.test.ts
├── .cursor/mcp.json         # Pre-configured for Cursor
├── .cursorrules             # SKILL.md → Cursor rules (auto-generated)
├── .windsurfrules           # SKILL.md → Windsurf rules (auto-generated)
├── SKILL.md                 # AI architectural contract
├── package.json
├── tsconfig.json
└── vitest.config.ts

Every file is real code — not stubs. The server boots, the tests pass, Cursor connects. Your AI agent already knows the conventions — SKILL.md is injected into IDE rules automatically.

---

Connect Your MCP Client

Cursor

Zero-click. CLI generates .cursor/mcp.json automatically.

Claude Desktop

Add to claude_desktop_config.json

Claude Code

claude mcp add my-server npx tsx src/server.ts

Claude Desktop

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["tsx", "src/server.ts"]
    }
  }
}

VS Code + Copilot

{
  "servers": {
    "my-server": {
      "command": "npx",
      "args": ["tsx", "src/server.ts"]
    }
  }
}

Windsurf / Cline

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["tsx", "src/server.ts"]
    }
  }
}

For SSE transport (multi-client, remote): vurb create my-api --transport sse

---

FILE-BASED ROUTING

Drop a file. It's a tool.
No imports, no registration.

autoDiscover

src/server.ts — scaffolded

import { ToolRegistry, autoDiscover } from '@vurb/core';

const registry = f.registry();
const discovered = await autoDiscover(
  registry,
  new URL('./tools', import.meta.url).pathname
);
console.error(`📦 Discovered ${discovered.length} tool file(s)`);

Directory structure becomes tool namespace:

naming convention

src/tools/
├── billing/
│   ├── get_invoice.ts    → billing.get_invoice
│   └── pay.ts            → billing.pay
├── users/
│   ├── list.ts           → users.list
│   └── ban.ts            → users.ban
└── system/
    └── health.ts         → system.health

Export Resolution

Priority	What it looks for	Example
1	export default	export default f.query('weather.get').handle(...)
2	Named tool export	export const tool = f.query(...)
3	Any exported builder	Scans all exports for getName()

src/tools/weather/get.ts

import { f } from '../../vurb.js';

export default f.query('weather.get')
  .describe('Get current weather for a city')
  .withString('city', 'City name')
  .handle(async (input) => {
    return { city: input.city, temp_c: 18, condition: 'Clear' };
  });

Multiple tools per file work too — all exported builders are discovered (Priority 3).

Advanced Options

Option	Default	Description
pattern	/(ts|js|mjs)$/	Regex filter for file names
recursive	true	Scan subdirectories
loader	'esm'	Module system ('esm' or 'cjs')
resolve	Priority cascade	Custom export resolver

---

Vectors

Vector	What it adds
vanilla	autoDiscover() file routing. Zero deps
prisma	Prisma schema + DB tool stubs + @vurb/prisma-gen
n8n	N8nConnector — n8n workflows as MCP tools
openapi	OpenAPI spec → Models/Views/Agents
oauth	RFC 8628 Device Flow + requireAuth()

different scaffolds

# Database-driven MCP server
vurb create inventory-api --vector prisma --transport sse

# n8n workflow bridge
vurb create ops-bridge --vector n8n

# Authenticated API
vurb create secure-api --vector oauth

Each vector adds its dependencies to package.json and environment variables to .env.example automatically.

---

SELF-HOSTED

Prefer your own infra?
Same code, any runtime.

Self-Hosted Alternatives

MANAGED

Vinkius Cloud

vurb deploy — global edge, DLP, kill switch.

Learn more →VERCEL

Vercel Edge

Next.js App Router — one line of code.

Read guide →CLOUDFLARE

Cloudflare Workers

Edge-native with D1, KV, and R2.

Read guide →

TIP

Install the Vinkius extension to monitor servers from VS Code, Cursor, or Windsurf — live connections, logs, and tool toggling.

---

Next Steps

BUILD

Building Tools

Semantic verbs, parameters, annotations.

Read more →VIEW

Presenter

Shape what the LLM sees.

Read more →GUARD

Middleware

Auth, rate limiting, logging.

Read more →

TESTING

Test Harness

In-memory tool assertions.

Read more →GOVERNANCE

Capability Lockfile

Lock your capability surface.

Read more →MANUAL

Traditional Setup

Step-by-step without scaffolding.

Read more →