MCP Server

Active

Derive MCP Server

to.derive/derive

Publish agent output to permanent versioned URLs, get team feedback, and revise collaboratively.

What is the Derive MCP server?

Derive is a workspace for publishing, reviewing, and versioning work created with AI agents. It provides durable URLs for HTML, Markdown, LaTeX, and other artifacts, with built-in version history, comments, and collaboration features. Agents can publish directly via MCP, CLI, or HTTP API, and read feedback to iterate on work.

Derive gives AI agents and teams a central place to publish, review, and improve generated artifacts. Every version gets a permanent URL with full history, comments pin to specific text, and connected agents can read feedback and publish revisions. Use it to keep work organized, shareable, and iterable across sessions and team members.

How to install Derive

Copy-paste configuration for popular MCP clients.

transport: http

Config generated by PluginBench — verify against the source before use.

~/.cursor/mcp.json

{
  "mcpServers": {
    "derive": {
      "url": "https://derive.to/mcp"
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

publish_artifact — Publish HTML, Markdown, LaTeX, or built sites to a permanent versioned URL
read_comments — Retrieve review comments and feedback attached to published artifacts
list_artifacts — Browse and search the library of published artifacts
create_context — Create reusable packages of instructions, skills, sources, and permissions for agents
request_review — Request formal review approval of a specific artifact version
update_artifact — Publish a new version of an existing artifact at the same URL

Use cases

Publish a design, report, or plan from Claude/Cursor and share it with your team for feedback
Have teammates or other agents comment on specific sections and request revisions
Maintain a permanent library of all work versions so you can reference or restore earlier iterations
Set up reusable Contexts (instructions + sources) that agents use to answer recurring questions
Request formal sign-off on critical versions before deployment or distribution

Derive MCP server FAQ

What is Derive?

Derive is a workspace where AI agents publish artifacts (HTML pages, documents, reports, designs) to permanent versioned URLs. Team members can comment on specific sections, and agents can read feedback and publish revisions—all at the same URL with full history.

Is Derive free?

Derive offers a free hosted tier at derive.to. It is also Fair Source licensed (FSL-1.1-ALv2) and fully self-hostable as a single container with SQLite, or at scale with Postgres and S3/R2.

How do I connect Derive to Claude or Cursor?

For Claude: run `claude mcp add --transport http derive https://derive.to/mcp`. For Cursor, use the one-click installer or add the same URL manually. You can also install the CLI with `npm i -g @derive-to/cli` and publish from the terminal.

Do I need to authenticate?

For the hosted service, you create an account at derive.to. For MCP, Derive uses OAuth so the agent acts at the role you grant (publish, suggest changes, etc.). Self-hosted instances can use static bearer tokens.

What file types can I publish?

HTML pages, Markdown documents, LaTeX papers, built sites (as .zip), and any content you can render in a browser. Each artifact gets a live preview, version history, and a shareable URL.

Can I self-host Derive?

Yes. Derive is a single Node container that runs on SQLite and local disk by default, or scales to Postgres and S3/R2. Follow the self-hosting quick start at docs.derive.to/self-hosting/quickstart/.

README (reference)

Source of truth, from the repository.

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/wordmark-on-dark.png"> <img alt="Derive" src="docs/assets/readme/wordmark-on-light.png" width="200"> </picture> </p> <h1 align="center">Publish, review, and own your AI artifacts.</h1> <p align="center"> One durable URL for every version, comment, revision, and decision. Your team reviews the work; any compatible agent can act on the feedback. Hosted, or one self-hosted container. </p> <p align="center"> <a href="https://derive.to"><b>Try free</b></a>  ·  <a href="https://docs.derive.to/self-hosting/quickstart/">Self-host</a>  ·  <a href="https://docs.derive.to">Docs</a> </p> <p align="center"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-FSL--1.1--ALv2-blue" alt="License: FSL-1.1-ALv2"></a> <a href="https://www.npmjs.com/package/@derive-to/cli"><img src="https://img.shields.io/npm/v/@derive-to/cli?label=%40derive-to%2Fcli&color=6b46ff" alt="npm @derive-to/cli"></a> <a href="https://www.npmjs.com/package/@derive-to/mcp"><img src="https://img.shields.io/npm/v/@derive-to/mcp?label=%40derive-to%2Fmcp&color=6b46ff" alt="npm @derive-to/mcp"></a> </p> <p align="center"> <img src="docs/assets/readme/hero.png" alt="The Derive library: published artifacts with live previews" width="900"> </p>

Try it now

No account or install is needed. One request publishes a live page:

curl -F file=@page.html https://derive.to/v1/drafts   # or a .zip of a whole site
# → a live URL, plus a claim link that turns the draft into a
#   permanent, versioned artifact in your workspace

Give your agent a durable place to publish, find, and improve work:

npx skills add derive-to/derive --skill derive        # any agent that reads skills
claude mcp add --transport http derive https://derive.to/mcp   # or connect over MCP

Or paste this into a compatible coding agent and let it set itself up:

I'd like you to set up Derive: where the work we make gets published, reviewed, and kept.

Install the skill if I have npm: npx skills add derive-to/derive --skill derive
Otherwise, read https://derive.to/skill.md and follow it (MCP server: https://derive.to/mcp).

Then pick a plan, report, or designed page we've worked on recently and publish it. If I'm not connected to Derive, use the anonymous draft flow. It needs no account and returns a live URL with a claim link. Send me both links.

What is Derive

Derive is a workspace for work made with agents. Give an HTML page, Markdown document, LaTeX paper, deck, or built site a lasting URL and version history. Publish from the browser, CLI, HTTP API, or a compatible agent over MCP. Keep the work private or share it, leave comments, edit it directly, and publish the next version at the same URL.

The content, version history, and comments stay with each artifact. A teammate or another agent can open the same URL and see what changed without reconstructing the work from a chat.

A workspace can also keep Contexts: reusable packages of instructions, skills, sources, and permissions. Agents use them to answer questions or do work, then publish results to the same artifact library.

Derive is Fair Source and self-hostable. Run it as one container on your own infrastructure or use the hosted app.

Features

Publish anything, get a permanent URL

HTML, Markdown, a LaTeX paper, or a whole built site. Every revision is a new version at the same URL, so a link you shared last week still resolves, and still shows its history.

</td> </tr> </table> <table> <tr> <td valign="top">

Comments and changes stay with the work

Share an artifact and @mention the people or agents who should weigh in. Comments pin to the exact text, direct edits create new versions, and connected agents can read feedback and publish focused revisions. When a decision truly needs sign-off, request a formal review of that version.

</td> <td width="52%" valign="top"> <img src="docs/assets/readme/feature-review.png" alt="An artifact with its comment and review panel open" width="100%"> </td> </tr> </table> <table> <tr> <td width="52%" valign="top"> <img src="docs/assets/readme/hero.png" alt="The Derive library: every published artifact with a live preview" width="100%"> </td> <td valign="top">

A library for published work

Every artifact lands in a library with a live preview. Pin the work you use often, find work shared with you, and organize related artifacts in collections.

</td> </tr> </table>

Also included:

Portable work. Content, versions, and comments stay with the artifact so another person or agent can continue the work.
Contexts. Reuse the same instructions, skills, sources, and permissions across questions and delegated work.
Checkpoints. Save the state of ongoing work in a page that a later session can open.
Sandboxed viewer. Artifacts run on an opaque origin, isolated from cookies and other artifacts.
Flexible storage. Use SQLite and local disk, or Postgres and S3/R2 at scale.
Live collaboration. Comments, optional approvals, and presence update over Server-Sent Events.
Share previews. Links show an artifact preview in Slack, Discord, X, and Notion.
CLI and MCP. Publish from the terminal or connect a compatible agent.
Access controls. Make work private, visible to the workspace, or public. Public links can also use a password.

Roadmap

The current roadmap lives at derive.to/roadmap and keeps its history at the same URL.

Get started

Hosted

The fastest path. No install.

Go to derive.to
Create an account
Publish your first artifact

You get a library, in-browser publishing, version history, and comments.

</td> <td width="50%" valign="top">

Self-host

One container is the whole product: API, web, sign-in, publishing, comments, and the sandboxed viewer, with SQLite and blobs in one volume.

Follow the self-hosting quick start to install a digest-pinned release or build the current checkout. It includes secure first-user bootstrap, readiness checks, and a verified first backup. See the deployment guide for Postgres, S3/R2, and cloud hosts.

</td> </tr> </table>

Want a complete artifact rather than a blank starter? Open or publish one of the official examples: a designed launch page, a research brief, or a living status report. Each shows a different starting point.

From the terminal

npm i -g @derive-to/cli
derive init my-doc --template slides   # templates: md · html · slides
cd my-doc
derive publish                         # versioned URL; the id is saved to derive.json

Connect your coding agent (MCP)

or one line for Claude Code: claude mcp add --transport http derive https://derive.to/mcp

# Derive is a remote MCP server (OAuth). Connect either client:
claude mcp add --transport http --scope project derive https://derive.to/mcp
codex mcp add derive --url https://derive.to/mcp

# or run a local stdio server (set DERIVE_SERVER; DERIVE_TOKEN for a static bearer):
npx -y @derive-to/mcp

The agent acts at the role you grant. Publish access publishes directly, as a kept and restorable version with the workspace notified; a lower scope suggests changes in comments for a person to apply. Full setup and tool guidance is in packages/mcp/SKILL.md.

How it works

One Node container is the whole product; storage is pluggable behind interfaces. The same image self-hosts on SQLite and local disk, scales on Postgres and S3/R2, or runs on Cloudflare Workers.

apps/api          HTTP API, sandboxed artifact serving, viewer
apps/web          web UI (TanStack Start, SPA mode, static bundle)
packages/core     domain: ports, publish, markdown render, viewer shell
packages/db       MetaStore: sqlite (default) · postgres · d1
packages/storage  BlobStore: fs (default) · s3/r2
packages/cli      derive init (md/html/slides) · derive publish <file|dir> · derive runner serve (serve a Context)
packages/mcp      Local compatibility MCP: eight agent tools + derive://guide

Every artifact ships OG and Twitter meta plus an oEmbed document, serves a live Server-Sent Events stream, and renders under a strict sandbox CSP on an opaque origin. See the artifact authoring standard for authoring and embed details.

License

Functional Source License (FSL-1.1-ALv2), fair source. Run, modify, and self-host Derive freely for any purpose except offering it as a competing commercial product or service. Each release automatically converts to Apache-2.0 two years after it ships. See the plain-English licensing guide.

Related MCP servers

JavaScript

View repository →

Plate

Minimal project management for teams and AI agents.