Ask
The agent calls create with the user's words.
A five-minute guide
ArtifactSmith
A place where agents turn their work into real documents you can open, share, and pull back later.
01 · 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.
Agents should hand back something you can look at, share, and pull back later.
02 · Why it exists
From chat walls to real pages
Agents can do good work and still 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.
03 · How it works
Four steps from request to link
Build
A model on any OpenAI-compatible endpoint writes it. A fixed renderer turns it into a document.
Preview
The result gets a private link for review.
Share or revoke
Share one exact version with a public link. Unshare it and the link returns 404.
04 · What it can make
Five useful formats
Web page
PDF
Word
Excel
Markdown
05 · Agent tools
A small tool set
| Tool | What it does |
|---|---|
| create | Queue a private build. |
| status | Poll or wait for the build status. |
| edit | Make a new version from the latest version. |
| inspect | Read the manifest, history, and share state. |
| list_artifacts | Show the artifact catalog. |
| export | Get a download link that is valid for 15 minutes. |
| share | Create a public link for one exact version. |
| unshare | Make a shared link return 404. |
| revoke_previews | Expire private preview links. |
| delete | Purge an artifact in two steps. |
06 · Safe by default
Private first
- Builds stay private until shared.
- Scripts are stripped.
- Nothing loads from outside when a page opens. Outside images become links.
- Private-network links are refused.
- Tokens are scoped to one workspace with set permissions.
- No usage data is sent anywhere.
07 · Try it
Three setup commands
Copy the example environment file, set your API key, prepare the local environment, and start the server.
cp .env.example .env
./scripts/ensure-local-env.sh
docker compose up -d --buildThen create a token with:
docker compose exec server artifactsmith token add --name agent --workspace alphaPoint an MCP client at the /mcp endpoint on port 8780 of the machine running it, with that token.
08 · License