llms.txt Content
# Vurb.ts
> The Express.js for MCP Servers. The framework for the AI era.
## What is Vurb.ts?
Vurb.ts is a TypeScript framework for building production-grade MCP (Model Context Protocol) servers. It provides structured routing, data shaping via Presenters, built-in security (DLP, PII redaction, Egress Firewall), middleware pipelines, and one-command deployment.
## Core Concepts
- **MVA Pattern** (Model-View-Agent): Replaces MVC for AI. Presenters shape what the LLM perceives — schema allowlists, business rules, affordances, and truncation.
- **Fluent API**: `f.query()`, `f.mutation()`, `f.action()` — semantic verbs with Zod validation and type inference.
- **Presenters**: Define once, reuse everywhere. Schema strips undeclared fields. Rules guide the agent. Suggestions enable agentic HATEOAS.
- **Middleware**: tRPC-style `f.middleware()` with context derivation. Auth, rate limiting, audit — write once, apply everywhere.
- **Self-Healing Errors**: `toolError()` and `f.error()` carry structured XML with recovery paths, available actions, and retry hints.
- **File-Based Routing**: `autoDiscover()` maps your directory tree to MCP tool definitions with discriminators and action consolidation.
## Security
- **Egress Firewall**: Zod schema strips undeclared fields at RAM level. New database columns are invisible unless declared.
- **PII Redaction**: `.redactPII()` — V8-optimized via fast-redact. GDPR, LGPD, HIPAA compliant.
- **State Gate**: Removes tools from `tools/list` based on workflow state (FSM). Anti-hallucination.
- **V8 Isolate Sandbox**: Zero access to `process`, `fs`, `net`. Sealed execution environment.
## Installation
```
npm install @vurb/core @modelcontextprotocol/sdk zod
```
## Quick Start
```
npx vurb create my-server
cd my-server
vurb dev
vurb deploy
```
## Links
- Docs: https://vurb.vinkius.com
- GitHub: https://github.com/vinkius-labs/vurb.ts
- npm: https://www.npmjs.com/package/@vurb/core
## Pages
- /introduction — Overview, i