Ask
The agent calls create with the user's words.
ArtifactSmith in five minutes
ArtifactSmith turns agent work into real pages and files you can look at, share, and pull back later.
1. What it is
ArtifactSmith is an open source artifact server for AI agents.
Agents call it over MCP to turn their work into web pages, PDFs, Word files, spreadsheets, and Markdown.
2. 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 is built for people who run their own agents on their own servers.
3. How it works
Build
A model on any OpenAI-compatible endpoint writes it. A fixed renderer turns it into a document.
Preview
The result has a private link.
PrivateShare or revoke
Share one exact version with a public link. Unshare it and the link returns 404.
Public when shared 404 when unshared4. What it can make
Web page
PDF
Word
Excel
Markdown
5. Tools an agent gets
| Tool | What it does |
|---|---|
create | Queues a private build. |
status | Polls or waits for the build and gives a private preview. |
edit | Creates a new version from the latest version. |
inspect | Shows the manifest, history, and share state. |
list_artifacts | Shows the artifact catalog. |
export | Creates a download link valid for 15 minutes. |
share | Creates a public link for one exact version. |
unshare | Makes the shared link return 404. |
revoke_previews | Expires private preview links. |
delete | Purges an artifact in two steps. |
6. Safe by default
- 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.
7. Try it in three commands
Copy the 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:
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.
8. License
MIT.