@vurb/aws

AWS Lambda & Step Functions Connector — Auto-discover cloud functions as MCP tools

AWS Lambda & Step Functions connector for Vurb.ts. Auto-discovers tagged resources and produces GroupedToolBuilders — so AI agents can invoke your cloud functions natively.

Quick Start

import { initVurb } from '@vurb/core';
import { discoverLambdas } from '@vurb/aws';

const f = initVurb<AppContext>();
const registry = f.registry();

// Auto-discover Lambda functions tagged with Vurb.ts:true
await discoverLambdas(registry, {
    region: 'us-east-1',
    tagFilter: { 'Vurb.ts': 'true' },
});

Features

Feature	Description
Auto-Discovery	Scans AWS for Lambda functions tagged for MCP exposure
Step Functions	Trigger and poll state machines as long-running MCP actions
GroupedToolBuilders	Each Lambda becomes a typed MCP tool with Zod validation
IAM Integration	Uses your existing AWS credentials and IAM roles
Multi-Region	Discover across multiple regions simultaneously

Step Functions

import { discoverStepFunctions } from '@vurb/aws';

await discoverStepFunctions(registry, {
    region: 'us-east-1',
    prefix: 'mcp-',
});

Installation

npm install @vurb/aws @aws-sdk/client-lambda

Peer Dependencies

Package	Version
`vurb`	`^2.0.0`
`@aws-sdk/client-lambda`	`^3.0.0` (optional)
`@aws-sdk/client-sfn`	`^3.0.0` (optional)

Requirements

Node.js ≥ 18.0.0
Vurb.ts ≥ 2.0.0 (peer dependency)
AWS credentials configured (env vars, IAM role, or AWS config file)

License

Apache-2.0