Build AI agents that seamlessly combine LLM reasoning with real-world actions via MCP tools ā in just a few lines of TypeScript.
npm install volcano-sdk
The TypeScript SDK for Multi-Provider AI Agents
Build agents that chain LLM reasoning with MCP tools. Mix OpenAI, Claude, Mistral in one workflow. Parallel execution, branching, loops. Native retries, streaming, and typed errors.
š Read the full documentation at volcano.dev ā
$3Chain steps with .then() and .run(). Promise-like syntax for building multi-step workflows. | $3LLM automatically selects and calls appropriate MCP tools based on the prompt. No manual routing required. | $3OpenAI, Anthropic, Mistral, Llama, Bedrock, Vertex, Azure. Switch providers per-step or use globally. |
$3Define specialized agents that autonomously coordinate based on descriptions. LLM automatically selects the right agent for each task - like automatic tool selection, but for agents. | $3Parallel execution, conditional branching, loops, and sub-agent composition for complex workflows. | $3Three retry strategies: immediate, delayed, and exponential backoff. Per-step timeout configuration. |
$3Stream step results as they complete, or stream individual tokens in real-time with metadata. Perfect for SSE, real-time chat UIs, and long-running tasks. | $3Native Model Context Protocol support with connection pooling, tool discovery, and authentication. | $3Full TypeScript support with type inference and IntelliSense for all APIs. |
$3Production-ready distributed tracing and metrics. Monitor performance, debug failures. Export to Jaeger, Prometheus, DataDog, NewRelic. | $3OAuth 2.1 and Bearer token authentication per MCP specification. Agent-level or handle-level configuration with automatic token refresh. | $3Intelligent connection pooling for MCP servers, tool discovery caching with TTL, and JSON schema validation for reliability. |
$3Ask questions about agent execution in natural language. Use an LLM to analyze results, explain what happened, and extract insights. |
``bash`
npm install volcano-sdk
That's it! Includes MCP support and all common LLM providers (OpenAI, Anthropic, Mistral, Llama, Vertex).
`ts
import { agent, llmOpenAI, mcp } from "volcano-sdk";
const llm = llmOpenAI({
apiKey: process.env.OPENAI_API_KEY!,
model: "gpt-4o-mini"
});
const astro = mcp("http://localhost:3211/mcp");
const results = await agent({ llm })
.then({
prompt: "Find the astrological sign for birthdate 1993-07-11",
mcps: [astro] // Automatic tool selection
})
.then({
prompt: "Write a one-line fortune for that sign"
})
.run();
console.log(results[1].llmOutput);
// Output: "Fortune based on the astrological sign"
`
`ts
import { agent, llmOpenAI, llmAnthropic, llmMistral } from "volcano-sdk";
const gpt = llmOpenAI({ apiKey: process.env.OPENAI_API_KEY! });
const claude = llmAnthropic({ apiKey: process.env.ANTHROPIC_API_KEY! });
const mistral = llmMistral({ apiKey: process.env.MISTRAL_API_KEY! });
// Use different LLMs for different steps
await agent()
.then({ llm: gpt, prompt: "Extract data from report" })
.then({ llm: claude, prompt: "Analyze for patterns" })
.then({ llm: mistral, prompt: "Write creative summary" })
.run();
``
We welcome contributions! Please see our Contributing Guide for details.
- š Report bugs or issues
- š” Request features or ask questions
- ā Star the project if you find it useful
Apache 2.0 - see LICENSE file for details.