Ask
Your agent calls create with the user's words.
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.
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, inspired by Meta's Muse artifacts and built for people who run their own agents on their own servers.
How it works
Build
A model on any OpenAI-compatible endpoint writes it. A fixed renderer turns it into a document.
Preview
Check a private link before anyone else can see the result.
Share or revoke
Share one exact version with a public link. Unshare it and the link returns 404.
What it can make
Web page
PDF
Word
Excel
Markdown
The tools an agent gets
| Tool | What it does |
|---|---|
| create | Queue a private build. |
| status | Poll or wait for the build. |
| edit | Create a new version from the latest one. |
| inspect | Read the manifest, history, and share state. |
| list_artifacts | Show the artifact catalog. |
| export | Get a download link 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. |
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.
Try it in three commands
Set your API key in the environment file, 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.
License
MIT