The Dreambase Plugin is the one-step install of everything Dreambase offers your AI tools: the Dreambase MCP server and the complete suite of nine Dreambase Skills, packaged as a single plugin for the marketplaces in Claude, ChatGPT, Cursor, and Codex.

One install replaces two manual setups. The MCP server brings your data to the agent — dashboards, prepared datasets, metric snapshots, Supabase health reports — and the skills teach the agent what to do with it. If you have already wired those up by hand, the plugin is the same thing with the assembly done for you, plus updates delivered through the marketplace instead of re-installs.

What's inside

The MCP server

The plugin configures the remote Dreambase MCP connection at https://app.dreambase.com/mcp. There is nothing to run locally, it is a remote MCP server (Streamable HTTP), authenticated with OAuth, scoped to your workspaces. On first use you sign in with Dreambase and authorize the client, exactly as in the manual setup.

The full MCP tool catalog: discovery, datasets, aggregates, and Supabase health reports, is covered in the Official Dreambase MCP doc.

Dreambase Skills

Every canonical skill from the open-source DreambaseAI/skills repository ships with the plugin. Agents load them automatically when a task matches what they cover:

• dreambase-mcp — the usage contract for the MCP server: call order, DuckDB dialect, connection discovery, error handling.

• dreambase-visualization-design — evidence-based chart and dashboard design; decides what to build, and why.

• dreambase-echarts — authors and validates Apache ECharts configs; builds the thing correctly the first time.

• dreambase-data-stories — reports, decks, one-pagers, and infographics with real narrative structure.

• dreambase-data-presentation — slide decks that hold up in a room: web decks, .pptx, Google Slides.

• dreambase-public-reports — disclosure-safe artifacts when real numbers inform something public.

• dreambase-industrial-schematics — the dark, cinematic technical-schematic style used across Dreambase's own marketing.

• dreambase-micrographic-design — the compliance-label aesthetic: spec sheets, rating plates, technical micro-type.

What each skill does in depth, and how they compose, is covered in the Dreambase Skills doc.

Installing in Claude Code

In any Claude Code session, add the marketplace and install the plugin.

Note: run both commands, the first registers Dreambase and the second installs the plugin (with MCP & skills)

/plugin marketplace add DreambaseAI/skills

/plugin install dreambase@dreambase

Restart the session, then authenticate the MCP server:

/mcp

Select dreambase, choose Authenticate, and sign in with Dreambase in the browser window that opens. You should see Authentication successful. Connected to dreambase. The skills are available immediately — type /dreambase to see them.

Installing in Claude Chat & Cowork App

Search for Dreambase in the connector directory under Settings → Connectors, add it, and click Connect to sign in with Dreambase. If the listing is not yet visible in your region or plan, add it as a custom connector instead — the steps, with screenshots, are in the Official Dreambase MCP doc.

For tool permissions we recommend always allow for the read-only tools and needs approval for write tools. Most of the catalog is read-only; only health report generation writes anything.

Installing in ChatGPT / Codex App

Search for Dreambase in the plugin directory, add it, check the terms box, and choose Sign in with Dreambase. Once connected, @ mention Dreambase in any conversation to use the MCP tools.

If the listing is not yet available to you, the manual path takes about a minute: add the MCP server from the Plugins panel (covered in the Official Dreambase MCP doc), and upload any skills you want as zip archives (covered in the Dreambase Skills doc, under drag-and-drop installation).

Installing in Cursor

Open Cursor's plugin settings, add DreambaseAI/skills as a plugin marketplace, and install dreambase. Cursor will show the MCP server under Needs Attention — click Authenticate, authorize Cursor, and you can @ mention Dreambase in any chat.

Prefer to configure only the MCP server by hand? The mcp.json snippet is in the Official Dreambase MCP doc.

Installing in Codex CLI

From the terminal:

Note: run both commands, the first registers Dreambase and the second installs the plugin (with MCP & skills)

codex plugin marketplace add DreambaseAI/skills

codex plugin add dreambase@dreambase

Then authenticate the server when it appears under Servers, or add it in the app under Settings → Plugins → MCPs as described in the Official Dreambase MCP doc.

Your first prompt

Once connected, the fastest way to see the whole stack work is to ask for something finished, not just data:

Use @Dreambase to pull our latest product KPIs and generate a report for our team using /dreambase-echarts following /dreambase-visualization-design, creating a data journal using /dreambase-data-stories

The MCP tools fetch prepared, pre-aggregated results — no schema introspection, no paging through raw rows — and the skills turn them into an artifact that reads like it was designed on purpose. Many more worked examples, with prompts, live in the MCP Use Cases doc.

Plugin or à la carte?

The plugin is the right default. Choose a manual install when you want only part of the stack:

• Just the MCP server — add it as a connector or MCP entry by hand. See the Official Dreambase MCP doc.

• Just the skills — install any subset with npx skills add DreambaseAI/skills, no Dreambase account required. See the Dreambase Skills doc for scoping, agent targeting, and forking.

• A customized skill — skills are plain Markdown. Fork the repository, add your house rules, and install your version; the plugin and a forked skill coexist fine.

Everything in the plugin is open source under MIT at github.com/DreambaseAI/skills — the repository is the plugin, so what you install is exactly what you can read.

Updating

Marketplace installs update through the marketplace: in Claude Code, /plugin shows installed plugins and available updates. Skills installed separately with the CLI update with npx skills update. Manual zip uploads do not auto-update; re-zip and re-upload when the repository changes, or move to the plugin.

Tips

• Connect your data in Dreambase first. The MCP tools return what your workspace already has. A workspace with connected sources and prepared datasets makes every prompt above dramatically better.

• Say which Dreambase workspace if you belong to several: every tool is workspace-scoped, and naming it saves a discovery round trip.

• Name Dreambase skills explicitly for high-stakes work. Agents under-trigger on skills. Typing /dreambase-public-reports before anything leaves the building is cheap insurance.

• Set read-only tools to always allow, write tools to needs approval. It keeps the flow fast without giving anything up.