Replo

Create artifact

create_artifact

Save a new HTML artifact in Files from files you wrote, in about a second. Send files keyed by path: index.html is the page, each *.insights.json is an Insights report, and report.insights.json is the main report (Replo renders the page around it when index.html is omitted). Add CSS, scripts, data and images alongside. Saves to My Files unless parentId names another folder. Returns the artifact folder ID and its viewer link; then call show_artifact with the folder ID so the user sees it. Creation is private; call set_file_sharing with the folder ID only when the user asks to share it. To have Replo's agent research and write the artifact from a request in words, use generate_artifact instead.

Input Schema

Name	Required	Description
`files`	Yes	The artifact's files keyed by relative path. Include index.html, report.insights.json, or both. index.html is the page. Link sibling files with relative URLs; scripts may load only from the artifact, cdnjs, jsDelivr /npm/, unpkg, the Tailwind CDN and the jQuery CDN, and other outbound requests are blocked. Each *.insights.json file is an Insights report document (version "2.0", the shape get_insights_report returns) whose saved queries run live for each viewer; embed one with <replo-report src="./sales.insights.json"></replo-report>. report.insights.json is the artifact's main report, the one the Insights report tools read, and without index.html Replo renders the page around it.
`title`	Yes	The artifact's name in Files.
`parentId`	No	The folder to save the artifact in, from list_files. Omit to save it in My Files.
`projectId`	Yes
`description`	No	The one-line summary shown on the artifact's card.

Schema Changelog

Changes observed during successful MCP inspections.

Changed9 schema fields changedOct 31, 2026

addedInput schema / properties / description

Added value: +{
+  "description": "The one-line summary shown on the artifact's card.",
+  "maxLength": 1000,
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / files

Added value: +{
+  "additionalProperties": {
+    "anyOf": [
+      {
+        "maxLength": 8000000,
+        "type": "string"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "base64": {
+            "description": "The file's bytes as base64.",
+            "maxLength": 8000000,
+            "type": "string"
+          }
+        },
+        "required": [
+          "base64"
+        ],
+        "type": "object"
+      }
+    ],
+    "description": "The file's text, or { base64 } for binary files such as images and fonts. The content type comes from the extension."
+  },
+  "description": "The artifact's files keyed by relative path. Include index.html, report.insights.json, or both. index.html is the page. Link sibling files with relative URLs; scripts may load only from the artifact, cdnjs, jsDelivr /npm/, unpkg, the Tailwind CDN and the jQuery CDN, and other outbound requests are blocked. Each *.insights.json file is an Insights report document (version \"2.0\", the shape get_insights_report returns) whose saved queries run live for each viewer; embed one with <replo-report src=\"./sales.insights.json\"></replo-report>. report.insights.json is the artifact's main report, the one the Insights report tools read, and without index.html Replo renders the page around it.",
+  "propertyNames": {
+    "description": "A path relative to the artifact folder, such as index.html, styles.css or images/logo.png.",
+    "maxLength": 2048,
+    "minLength": 1,
+    "type": "string"
+  },
+  "type": "object"
+}

removedInput schema / properties / instructions

Removed value: -{
-  "description": "Requested changes for this operation only. Include necessary references, not conversation history, credentials, or unrelated personal data.",
-  "maxLength": 7500,
-  "minLength": 1,
-  "type": "string"
-}

removedInput schema / properties / operationId

Removed value: -{
-  "description": "Generate a fresh UUID for each new instruction. Reuse it with identical arguments on a retry to avoid duplicate work.",
-  "format": "uuid",
-  "type": "string"
-}

addedInput schema / properties / parentId

Added value: +{
+  "description": "The folder to save the artifact in, from list_files. Omit to save it in My Files.",
+  "format": "uuid",
+  "type": "string"
+}

removedInput schema / properties / sessionId

Removed value: -{
-  "description": "Omit to start this operation. To continue, supply the returned sessionId with the same operation and target; mismatches and legacy sessions are rejected.",
-  "format": "uuid",
-  "type": "string"
-}

removedInput schema / properties / sources

Removed value: -{
-  "default": [],
-  "description": "Optional existing reports, analytics SQL, or Files documents. The agent reads and queries these sources. For standalone artifacts, omit sources and provide instructions.",
-  "items": {
-    "oneOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "reportId": {
-            "format": "uuid",
-            "type": "string"
-          },
-          "scope": {
-            "additionalProperties": false,
-            "description": "Override selected report defaults. Filters replace the default filter list; omitted fields retain the report's defaults.",
-            "properties": {
-              "breakdown": {
-                "anyOf": [
-                  {
-                    "properties": {
-                      "fieldKey": {
-                        "maxLength": 120,
-                        "minLength": 1,
-                        "type": "string"
-                      },
-                      "limit": {
-                        "exclusiveMinimum": 0,
-                        "maximum": 200,
-                        "type": "integer"
-                      }
-                    },
-                    "required": [
-                      "fieldKey"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "dateRange": {
-                "anyOf": [
-                  {
-                    "properties": {
-                      "comparison": {
-                        "enum": [
-                          "previous_period",
-                          "previous_year",
-                          "none"
-                        ],
-                        "type": "string"
-                      },
-                      "presetId": {
-                        "enum": [
-                          "last_7_days",
-                          "last_14_days",
-                          "last_30_days",
-                          "last_90_days",
-                          "last_16_months",
-                          "this_week",
-                          "last_week",
-                          "this_month",
-                          "last_month",
-                          "year_to_date",
-                          "custom"
-                        ],
-                        "type": "string"
-                      },
-                      "since": {
-                        "format": "date",
-                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-                        "type": "string"
-                      },
-                      "until": {
-                        "format": "date",
-                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "presetId",
-                      "since",
-                      "until",
-                      "comparison"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "filters": {
-                "items": {
-                  "properties": {
-                    "fieldKey": {
-                      "maxLength": 120,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "isProjectDefault": {
-                      "const": true,
-                      "description": "Marks an automatically seeded project domain, not a viewer selection.",
-                      "type": "boolean"
-                    },
-                    "op": {
-                      "enum": [
-                        "equals",
-                        "notEquals",
-                        "in",
-                        "notIn",
-                        "contains",
-                        "notContains",
-                        "startsWith",
-                        "isSet",
-                        "isNotSet",
-                        "greaterThan",
-                        "greaterThanOrEqual",
-                        "lessThan",
-                        "lessThanOrEqual"
-                      ],
-                      "type": "string"
-                    },
-                    "value": {
-                      "anyOf": [
-                        {
-                          "type": "string"
-                        },
-                        {
-                          "type": "number"
-                        },
-                        {
-                          "type": "boolean"
-                        },
-                        {
-                          "items": {
-                            "type": [
-                              "string",
-                              "number"
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    }
-                  },
-                  "required": [
-                    "fieldKey",
-                    "op"
-                  ],
-                  "type": "object"
-                },
-                "maxItems": 20,
-                "type": "array"
-              }
-            },
-            "type": "object"
-          },
-          "type": {
-            "const": "insightsReport",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "reportId"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "query": {
-            "maxLength": 50000,
-            "minLength": 1,
-            "type": "string"
-          },
-          "type": {
-            "const": "analytics",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "query"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "fileId": {
-            "format": "uuid",
-            "type": "string"
-          },
-          "type": {
-            "const": "file",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "fileId"
-        ],
-        "type": "object"
-      }
-    ]
-  },
-  "maxItems": 10,
-  "type": "array"
-}

addedInput schema / properties / title

Added value: +{
+  "description": "The artifact's name in Files.",
+  "maxLength": 200,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "projectId",
-  "instructions",
-  "operationId"
-]New value: +[
+  "projectId",
+  "title",
+  "files"
+]

Changed5 schema fields changedOct 31, 2026

removedInput schema / $schema

Removed value: -"https://json-schema.org/draft/2020-12/schema"

removedInput schema / properties / operationId / pattern

Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"

removedInput schema / properties / projectId / pattern

Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"

removedInput schema / properties / sessionId / pattern

Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"

changedInput schema / properties / sources / items / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "reportId": {
-        "format": "uuid",
-        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-        "type": "string"
-      },
-      "scope": {
-        "additionalProperties": false,
-        "description": "Override selected report defaults. Filters replace the default filter list; omitted fields retain the report's defaults.",
-        "properties": {
-          "breakdown": {
-            "anyOf": [
-              {
-                "properties": {
-                  "fieldKey": {
-                    "maxLength": 120,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "limit": {
-                    "exclusiveMinimum": 0,
-                    "maximum": 200,
-                    "type": "integer"
-                  }
-                },
-                "required": [
-                  "fieldKey"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "dateRange": {
-            "anyOf": [
-              {
-                "properties": {
-                  "comparison": {
-                    "enum": [
-                      "previous_period",
-                      "previous_year",
-                      "none"
-                    ],
-                    "type": "string"
-                  },
-                  "presetId": {
-                    "enum": [
-                      "last_7_days",
-                      "last_14_days",
-                      "last_30_days",
-                      "last_90_days",
-                      "last_16_months",
-                      "this_week",
-                      "last_week",
-                      "this_month",
-                      "last_month",
-                      "year_to_date",
-                      "custom"
-                    ],
-                    "type": "string"
-                  },
-                  "since": {
-                    "format": "date",
-                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-                    "type": "string"
-                  },
-                  "until": {
-                    "format": "date",
-                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "presetId",
-                  "since",
-                  "until",
-                  "comparison"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "filters": {
-            "items": {
-              "properties": {
-                "fieldKey": {
-                  "maxLength": 120,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "isProjectDefault": {
-                  "const": true,
-                  "description": "Marks an automatically seeded project domain, not a viewer selection.",
-                  "type": "boolean"
-                },
-                "op": {
-                  "enum": [
-                    "equals",
-                    "notEquals",
-                    "in",
-                    "notIn",
-                    "contains",
-                    "notContains",
-                    "startsWith",
-                    "isSet",
-                    "isNotSet",
-                    "greaterThan",
-                    "greaterThanOrEqual",
-                    "lessThan",
-                    "lessThanOrEqual"
-                  ],
-                  "type": "string"
-                },
-                "value": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "items": {
-                        "type": [
-                          "string",
-                          "number"
-                        ]
-                      },
-                      "type": "array"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "fieldKey",
-                "op"
-              ],
-              "type": "object"
-            },
-            "maxItems": 20,
-            "type": "array"
-          }
-        },
-        "type": "object"
-      },
-      "type": {
-        "const": "insightsReport",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "reportId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "query": {
-        "maxLength": 50000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "type": {
-        "const": "analytics",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "query"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "fileId": {
-        "format": "uuid",
-        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-        "type": "string"
-      },
-      "type": {
-        "const": "file",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "fileId"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "reportId": {
+        "format": "uuid",
+        "type": "string"
+      },
+      "scope": {
+        "additionalProperties": false,
+        "description": "Override selected report defaults. Filters replace the default filter list; omitted fields retain the report's defaults.",
+        "properties": {
+          "breakdown": {
+            "anyOf": [
+              {
+                "properties": {
+                  "fieldKey": {
+                    "maxLength": 120,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "limit": {
+                    "exclusiveMinimum": 0,
+                    "maximum": 200,
+                    "type": "integer"
+                  }
+                },
+                "required": [
+                  "fieldKey"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "dateRange": {
+            "anyOf": [
+              {
+                "properties": {
+                  "comparison": {
+                    "enum": [
+                      "previous_period",
+                      "previous_year",
+                      "none"
+                    ],
+                    "type": "string"
+                  },
+                  "presetId": {
+                    "enum": [
+                      "last_7_days",
+                      "last_14_days",
+                      "last_30_days",
+                      "last_90_days",
+                      "last_16_months",
+                      "this_week",
+                      "last_week",
+                      "this_month",
+                      "last_month",
+                      "year_to_date",
+                      "custom"
+                    ],
+                    "type": "string"
+                  },
+                  "since": {
+                    "format": "date",
+                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+                    "type": "string"
+                  },
+                  "until": {
+                    "format": "date",
+                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "presetId",
+                  "since",
+                  "until",
+                  "comparison"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "filters": {
+            "items": {
+              "properties": {
+                "fieldKey": {
+                  "maxLength": 120,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "isProjectDefault": {
+                  "const": true,
+                  "description": "Marks an automatically seeded project domain, not a viewer selection.",
+                  "type": "boolean"
+                },
+                "op": {
+                  "enum": [
+                    "equals",
+                    "notEquals",
+                    "in",
+                    "notIn",
+                    "contains",
+                    "notContains",
+                    "startsWith",
+                    "isSet",
+                    "isNotSet",
+                    "greaterThan",
+                    "greaterThanOrEqual",
+                    "lessThan",
+                    "lessThanOrEqual"
+                  ],
+                  "type": "string"
+                },
+                "value": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "items": {
+                        "type": [
+                          "string",
+                          "number"
+                        ]
+                      },
+                      "type": "array"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "fieldKey",
+                "op"
+              ],
+              "type": "object"
+            },
+            "maxItems": 20,
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "type": {
+        "const": "insightsReport",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "reportId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "query": {
+        "maxLength": 50000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "const": "analytics",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "query"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "fileId": {
+        "format": "uuid",
+        "type": "string"
+      },
+      "type": {
+        "const": "file",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "fileId"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedOct 30, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / description
```
Added value: +"PublicCreateArtifact"
```

AddedOct 22, 2026

TDQS

A4.4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare a non-readonly, non-destructive, non-idempotent, closed-world write, so the bar is lower; the description still adds real context — creation is private by default, defaults to My Files, runs in about a second, and returns a folder ID plus viewer link that must be fed to show_artifact. It does not say what happens on repeat calls with the same title, which matters given idempotentHint=false.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Long but dense and front-loaded: the save action and file-keying model come first, follow-up calls next, the alternative sibling last. A few clauses (report.insights.json rendering, Insights report semantics) duplicate the schema's files description and could be trimmed without loss.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description covers what matters: the artifact folder ID and viewer link are named, and the agent is told the exact next call. Combined with a nested files object and 80% schema coverage, nothing an agent needs to invoke this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 80%, so the schema already carries the parameter burden, and the description largely restates it: files keyed by path, index.html as the page, *.insights.json as reports, and parentId defaulting to My Files are all documented in the schema text. It adds little syntax or format detail beyond that baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Save a new HTML artifact in Files from files you wrote" gives a specific verb, resource, and source, and the closing sentence distinguishes it from generate_artifact (research-and-write) and implies update_artifact handles changes. An agent can select it against its siblings without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit routing is provided in both directions: use generate_artifact when the request is in words, call show_artifact after creation so the user sees it, and call set_file_sharing only when the user asks to share. Prerequisites and follow-up sequencing are spelled out rather than inferred.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Replo tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?