Plugin Overview

Extend Atlas with datasource, context, interaction, action, and sandbox plugins.

Atlas plugins extend the agent with new capabilities. Each plugin is a factory function registered in atlas.config.ts. The Plugin SDK (@useatlas/plugin-sdk) provides type definitions and helpers for all five plugin types.

Available Plugins

Atlas ships with 15 reference plugins covering all five types:

Datasource Plugins

Connect additional databases and APIs as query targets. See Datasource Plugins for full configuration details.

Plugin	Package	Connects to
ClickHouse	`@atlas/plugin-clickhouse-datasource`	ClickHouse analytics database
DuckDB	`@atlas/plugin-duckdb-datasource`	DuckDB embedded analytics
MySQL	`@atlas/plugin-mysql-datasource`	MySQL / MariaDB
Snowflake	`@atlas/plugin-snowflake-datasource`	Snowflake Data Cloud
Salesforce	`@atlas/plugin-salesforce-datasource`	Salesforce CRM (SOQL)

Sandbox Plugins

Provide isolation backends for the explore and Python tools. See Sandbox Plugins for full configuration details.

Plugin	Package	Isolation Type	Priority
E2B	`@atlas/plugin-e2b-sandbox`	Firecracker microVM	90
Daytona	`@atlas/plugin-daytona-sandbox`	Managed cloud sandbox	85
nsjail	`@atlas/plugin-nsjail-sandbox`	Linux namespace sandbox	75
Sidecar	`@atlas/plugin-sidecar-sandbox`	HTTP-isolated container	50
Vercel	`@atlas/plugin-vercel-sandbox`	Firecracker microVM (Vercel)	100

Interaction Plugins

Add new surfaces for users to interact with Atlas. See Interaction Plugins.

Plugin	Package	Surface
MCP	`@atlas/plugin-mcp-interaction`	Model Context Protocol (stdio/SSE)
Slack	`@atlas/plugin-slack-interaction`	Slack bot (commands, threads, OAuth)

Action Plugins

Let the agent perform write operations with approval controls. See Action Plugins.

Plugin	Package	Action
Email	`@atlas/plugin-email-action`	Send email reports via Resend
JIRA	`@atlas/plugin-jira-action`	Create JIRA tickets

Context Plugins

Inject additional knowledge into the agent's system prompt. See Context Plugins.

Plugin	Package	Source
YAML Context	`@atlas/plugin-yaml-context`	Semantic layer (entities, glossary, metrics)

Quick Start

Install the Plugin SDK and register plugins in your config:

bun add @useatlas/plugin-sdk

// atlas.config.ts
import { defineConfig } from "@atlas/api/lib/config";
import { clickhousePlugin } from "@atlas/plugin-clickhouse-datasource";
import { e2bSandboxPlugin } from "@atlas/plugin-e2b-sandbox";

export default defineConfig({
  plugins: [
    clickhousePlugin({ url: process.env.CLICKHOUSE_URL! }),
    e2bSandboxPlugin({ apiKey: process.env.E2B_API_KEY! }),
  ],
});

Building Your Own

See the Plugin Authoring Guide for a step-by-step tutorial on creating custom plugins.

On this page