A five-minute guide

ArtifactSmith, made visible.

Turn an agent's work into a real page you can look at, share, and pull back later.

What it is

ArtifactSmith is an open source artifact server for AI agents. Agents call it over MCP to turn work into web pages, PDFs, Word files, spreadsheets, and Markdown.

Why it exists

Agents can do good work and then hand back a wall of chat text. ArtifactSmith lets them hand back real pages you can look at, share, and pull back later.

It was inspired by Meta's Muse artifacts and built for people who run their own agents on their own servers.

How it works

01

Ask

The agent calls create with the user's words.

02

Build

A model on any OpenAI-compatible endpoint writes it. A fixed renderer turns it into a document.

03

Preview

The result gets a private link.

04

Share or revoke

A public link points to one exact version. Unshare makes it return 404.

What it can make

Web page PDF Word Excel Markdown

Tools for an agent

Tool What it does
createQueue a private build.
statusPoll or wait for the build.
editMake a new version from the latest one.
inspectRead the manifest, history, and share state.
list_artifactsShow the artifact catalog.
exportGet a download link valid for 15 minutes.
shareCreate a public link for one exact version.
unshareMake the public link return 404.
revoke_previewsExpire private preview links.
deletePurge an artifact in two steps.

Safe by default

Try it

Run these three commands:

cp .env.example .env ./scripts/ensure-local-env.sh docker compose up -d --build

Then create a token:

docker compose exec server artifactsmith token add --name agent --workspace alpha

Point an MCP client at the /mcp endpoint on port 8780 of the machine running it, with that token.

License

ArtifactSmith is licensed under MIT.

Give your agent somewhere to put the work.