🛡️ TypeScript-First

Full type safety with IntelliSense. Catch errors before runtime.

📊 Observability

OpenTelemetry traces and metrics. Export to Jaeger, Prometheus, DataDog, or any OTLP backend.

⚡ Production-Ready

Built-in retries, timeouts, error handling, and connection pooling. Battle-tested at scale.

Explore all features →

Quick Start

Installation

npm install @volcano.dev/agent

That's it! Includes MCP support and all common LLM providers (OpenAI, Anthropic, Mistral, Llama, Vertex).

View installation guide →

Hello World with Automatic Tool Selection

import { agent, llmOpenAI, mcp } from "@volcano.dev/agent";

const llm = llmOpenAI({ 
  apiKey: process.env.OPENAI_API_KEY!, 
  model: "gpt-4o-mini" 
});

const weather = mcp("http://localhost:8001/mcp");
const tasks = mcp("http://localhost:8002/mcp");

// Agent automatically picks the right tools
const results = await agent({ llm })
  .then({ 
    prompt: "What's the weather in Seattle? If it will rain, create a task to bring an umbrella",
    mcps: [weather, tasks]  // LLM chooses which tools to call
  })
  .run();

// Ask questions about what happened
const summary = aw...