artifact-create
Create a new artifact (app) from prompt (p2c), website clone (l2c), Figma (f2c), empty repo, or import
LABSCO SUMMARY
Minting a scoped git token is the tool that makes this more than a generator.
Generated apps usually arrive as a download and stop being editable by the agent that made them. Here the agent can ask for a short-lived token and go on working in the repo — which is the difference between a demo and something you iterate. The other detail worth noting is codegen-figma_to_code: it writes into your project without creating an artifact, so you can use the Figma pipeline without hosting anything on AgentGrid.io.
What it is
AgentGrid.io is Anima's shared workspace where people and AI agents build, host and publish artifacts; this is its hosted endpoint. An artifact is a live app or document with a git repository behind it, created from a prompt, a site to clone, a Figma file, an empty repo or an import. Anima's older guide connects to public-api.animaapp.com, which reaches the same service but signs you in separately.
What you get
- Create an artifact from a prompt, a website clone, Figma, an empty repo or a zip import
- Poll generation status, with a blocking wait of about 45 seconds
- Read and change an artifact's files directly, or take a short-lived scoped git token and work in its repo
- Publish to a live public URL, unpublish while keeping the code and subdomain, duplicate, or update name and privacy
- Read, reply to and resolve the review comments people leave on an artifact
- List your workspaces and artifacts, and move an artifact from one workspace to another
- Figma-to-code that writes design-aware files into your own project without creating an artifact at all
Requirements
Browser authorisation on first connect, with an optional Figma link. The free plan allows five Figma imports or website clones and five code generations; every MCP-driven generation counts against that quota. An Enterprise-only design-system group is gated separately.
Setup effort
Paste a URL, then sign in — add the endpoint to your client and sign in to Anima
USE CASES
01
Getting from a design to a running app
Create the artifact from a Figma file, wait for generation, then publish it to a public URL.
02
Editing what was generated
Mint a scoped git token and work in the artifact's repo instead of regenerating from scratch.
03
Using Figma frames in your own codebase
Generate design-aware files for your stack without creating an artifact or moving hosting.
04
Taking something offline without losing it
Unpublish keeps the code and the subdomain, so the URL can come back.
20 tools
Listed in project docs. Your client may show a different list.
artifact-create_knowledge
A Knowledge Base is an app artifact created from AgentGrid.io's current built-in template. Takes an optional workspaceId.
artifact-duplicate
Clone an artifact into a new independent one in the team's Default workspace (not idempotent)
artifact-get_zip_upload_url
Step 1 of zip import flow; returns single-use uploadUrl (50MB limit, 30-min window)
artifact-explore
Inspect an artifact's files (action: tree, search, read or history).
artifact-edit
Change an artifact's files; all changes land as one commit, applied in order.
artifact-get_git_token
Mint short-lived scoped git token to read/edit an artifact's repo
artifact-status
Poll async generation status; wait:true blocks until ready/failed or ~45s
artifact-update_metadata
Update artifact name and/or privacy (public|private); never touches code
artifact-publish
Deploy the app to a live public URL
artifact-unpublish
Take a published artifact offline (keeps code and subdomain)
artifact-delete
Delete an artifact. Use this tool only after the user explicitly requests deletion. The tool makes a reversible soft deletion. MCP cannot permanently delete the artifact.
artifact-get_asset_upload_url
Stage a large asset: for an image, font or media file over 256 KB, which is the most artifact-edit takes inline.
review-list
Read the comments left for you; omit sessionId for every open review addressed to you, across every artifact you can reach.
review-resolve
Close one comment.
review-reply
Answer one comment, leave it open.
workspace-list_workspaces
List the workspaces you can reach; each row carries workspaceId, name, isGeneral and capabilities (what you may do there).
workspace-list_artifacts
List the team's artifacts (sessionIds for app rows; may set truncated)
workspace-move_artifact
Move an artifact to another workspace of the same team; the repository, URL, history and live deployment are unchanged.
codegen-figma_to_code
Generate design-aware code files for your own project from Figma frames (no artifact created); returns files, assets, snapshot URLs, guidelines
BEFORE YOU INSTALL
What to know first
Tools you get
20 tools named in the project's documentation.
Extra tools, depending on your plan:
- Enterprise workspace 2 tools
Requires
an MCP client that can reach a remote endpoint
INSTALLATION
Connect your client
Add the endpoint to your client and sign in to Anima.
Server setup
ENDPOINT URL
https://api.agentgrid.io/v1/mcpMCP Clients
Claude Code — plugin
CLAUDE CODE — PLUGIN · IN CLIENT
/plugin marketplace add AnimaApp/mcp-server-guide
/plugin install anima@mcp-server-guideRun both inside Claude Code. This configures the MCP server and installs the skill; authenticate when prompted.
Claude Code — manual
CLAUDE CODE — MANUAL · TERMINAL
claude mcp add --transport http anima https://api.agentgrid.io/v1/mcpCodex
CODEX · TERMINAL
codex mcp add anima --url https://api.agentgrid.io/v1/mcpVS Code
VS CODE · JSON
{
"servers": {
"anima": {
"type": "http",
"url": "https://api.agentgrid.io/v1/mcp"
}
}
}Cursor, Any MCP client
JSON
{
"mcpServers": {
"anima": {
"url": "https://api.agentgrid.io/v1/mcp"
}
}
}
