volcano-agent-sdk
π Build AI agents that seamlessly combine LLM reasoning with real-world actions via MCP tools β in just a few lines of TypeScript.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/kong--volcano-agent-sdk)HTML
<a href="/listings/kong--volcano-agent-sdk"><img src="/api/listings/kong--volcano-agent-sdk/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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 β](https://volcano.dev/docs#installation)**
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 = await results.summary(llm);
console.log(summary);Multi-Agent Coordinator
import { agent, llmOpenAI } from "@volcano.dev/agent";
const llm = llmOpenAI({ apiKey: process.env.OPENAI_API_KEY! });
// Define specialized agents
const researcher = agent({ llm, name: 'researcher', description: 'Finds facts and data' })
.then({ prompt: "Research the topic." })
.then({ prompt: "Summarize the research." });
const writer = agent({ llm, name: 'writer', description: 'Creates content' })
.then({ prompt: "Write content." });
// Coordinator autonomously delegates to specialists
const results = await agent({ llm })
.then({
prompt: "Write a blog post about quantum computing",
agents: [researcher, writer] // Coordinator decides when done
})
.run();
// Ask what happened
const post = await results.ask(llm, "Show me the final blog post");
console.log(post);**[View more examples β](https://volcano.dev/docs/examples)**
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 174 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- [](https://github.com/Kong/volcano-agent-sdk/actions/workflows/ci.yml)
- [](LICENSE)
- [](https://www.npmjs.com/package/@volcano.dev/agent)
- # π Volcano Agent 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 β](https://volcano.dev/)**
- ## β¨ Features
- <table>
- <tr>
- <td width="33%">
- ### π€ Automatic Tool Selection
- LLM automatically picks which MCP tools to call based on your prompt. No manual routing needed.
- </td>
- <td width="33%">
- ### π§© Multi-Agent Crews
- Define specialized agents and let the coordinator autonomously delegate tasks. Like automatic tool selection, but for agents.
- </td>
- <td width="33%">
- ### π¬ Conversational Results
- Ask questions about what your agent did. Use `.summary()` or `.ask()` instead of parsing JSON.
- </td>
- </tr>
- <tr>
- <td width="33%">
- ### π§ 100s of Models
- OpenAI, Anthropic, Mistral, Bedrock, Vertex, Azure. Switch providers per-step or globally.
- </td>
- <td width="33%">
- ### π Advanced Patterns
- Parallel execution, branching, loops, sub-agent composition. Enterprise-grade workflow control.
- </td>
- <td width="33%">
- ### π‘ Streaming
- Stream tokens in real-time as LLMs generate them. Perfect for chat UIs and SSE endpoints.
- </td>
- </tr>
- <tr>
- <td width="33%">
- ### π‘οΈ TypeScript-First
- Full type safety with IntelliSense. Catch errors before runtime.
- </td>
- <td width="33%">
- ### π Observability
- OpenTelemetry traces and metrics. Export to Jaeger, Prometheus, DataDog, or any OTLP backend.
- </td>
- <td width="33%">
- ### β‘ Production-Ready
- Built-in retries, timeouts, error handling, and connection pooling. Battle-tested at scale.
- </td>
- </tr>
- </table>
- **[Explore all features β](https://volcano.dev/docs#key-features)**
- ## Quick Start
- ### Installation
- ```bash
- npm install @volcano.dev/agent
- ```
- That's it! Includes MCP support and all common LLM providers (OpenAI, Anthropic, Mistral, Llama, Vertex).
- **[View installation guide β](https://volcano.dev/docs#installation)**
- ### Hello World with Automatic Tool Selection
- ```ts
- 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 = await results.summary(llm);
- console.log(summary);
- ```
- ### Multi-Agent Coordinator
- ```ts
- import { agent, llmOpenAI } from "@volcano.dev/agent";
- const llm = llmOpenAI({ apiKey: process.env.OPENAI_API_KEY! });
- // Define specialized agents
- const researcher = agent({ llm, name: 'researcher', description: 'Finds facts and data' })
- .then({ prompt: "Research the topic." })
- .then({ prompt: "Summarize the research." });
- const writer = agent({ llm, name: 'writer', description: 'Creates content' })
- .then({ prompt: "Write content." });
- // Coordinator autonomously delegates to specialists
- const results = await agent({ llm })
- .then({
- prompt: "Write a blog post about quantum computing",
- agents: [researcher, writer] // Coordinator decides when done
- })
- .run();
- // Ask what happened
- const post = await results.ask(llm, "Show me the final blog post");
- console.log(post);
- ```
- **[View more examples β](https://volcano.dev/docs/examples)**
- ## Documentation
- ### π Comprehensive Guides
- - **[Getting Started](https://volcano.dev/docs)** - Installation, quick start, core concepts
- - **[LLM Providers](https://volcano.dev/docs/providers)** - OpenAI, Anthropic, Mistral, Llama, Bedrock, Vertex, Azure
- - **[MCP Tools](https://volcano.dev/docs/mcp-tools)** - Automatic selection, OAuth authentication, connection pooling
- - **[Advanced Patterns](https://volcano.dev/docs/patterns)** - Parallel, branching, loops, multi-LLM workflows
- - **[Features](https://volcano.dev/docs/features)** - Streaming, retries, timeouts, hooks, error handling
- - **[Observability](https://volcano.dev/docs/observability)** - OpenTelemetry traces and metrics
- - **[API Reference](https://volcano.dev/docs/api)** - Complete API documentation
- - **[Examples](https://volcano.dev/docs/examples)** - Ready-to-run code examples
- ## Contributing
- We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
- ### Questions or Feature Requests?
- - π [Report bugs or issues](https://github.com/Kong/volcano-agent-sdk/issues)
- - π‘ [Request features or ask questions](https://github.com/Kong/volcano-agent-sdk/discussions)
- - β [Star the project](https://github.com/Kong/volcano-agent-sdk) if you find it useful
- ## License
- Apache 2.0 - see [LICENSE](LICENSE) file for details.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.