# MCP tools

> One address, superartifacts.app/mcp, and twenty tools your agent calls for you: what each one does, and a prompt that reaches it.

Kind: reference · ~3 min · Verified v0.127.3 · Next: [REST API](https://pr-1797-stg.superartifacts.app/docs/reference/api.md)

Your agent reaches Super Artifacts through one address, its MCP server. Connect once and
the agent can publish, read and share for you.

## Connect

Pick your agent and copy the prompt. Paste it into the agent; it does the setup and asks you
only for what needs your hands, such as clicking **Allow** in the browser.

### Claude Code

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Claude Desktop

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### ChatGPT

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Codex

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Hermes

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### OpenClaw

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Cursor

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### GitHub Copilot

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Gemini CLI

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Windsurf

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Zed

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Devin

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Grok Build

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Antigravity

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### OpenCode

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Goose

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Cline

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Amp

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Kiro

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Junie

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Warp

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Qwen Code

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Kilo Code

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

### Manus

```prompt
give yourself access to Super Artifacts
by following the guide at:
https://pr-1797-stg.superartifacts.app/docs/agent-setup.md
and refer to:
https://pr-1797-stg.superartifacts.app/llms.txt
for the documentation index.
```

If your app adds connectors in its settings instead, give it this address:

```
https://superartifacts.app/mcp
```

The [Agents page](https://superartifacts.app/agents) has the steps for each agent and lists
every agent you have connected.

## Twenty tools

| Tool | Does | Example prompt |
| --- | --- | --- |
| `super_whoami` | Who am I publishing as | Which Super Artifacts account are you publishing to? |
| `super_publish` | Publish an artifact | Publish this page and send me the link. |
| `super_upload` | Stage files for a publish | Publish these screenshots in a page. Upload the files, do not paste them. |
| `super_artifacts` | Your artifacts, their versions and files | List my artifacts and open the newest one so I can see it. |
| `super_artifact_set` | Change what an artifact serves, and to whom | Put version 3 of the launch page back live. |
| `super_data` | Read what visitors submitted | Show me every RSVP people sent. |
| `super_data_query` | Aggregate what was collected | How many RSVPs said yes, by dietary need? |
| `super_data_write` | Write rows into your artifact | Fill the recital program with these ten pieces. |
| `super_data_schema` | What data exists, and what it means | What data do my artifacts collect, and what does each field mean? |
| `super_entries` | Read or write a collection's entries | Add these five products to my Catalogue collection. |
| `super_secret_use` | Call an API with a stored secret you cannot read | Check my Stripe balance with the key in my Vendors collection. |
| `super_templates` | Find, list and read templates | Find me a template for a weekly team update. |
| `super_template_save` | Create or revise a template draft | Turn this artifact into a template draft. |
| `super_template_action` | Install, rate, report, roll back or verify a template | Install the retro board template. |
| `super_release_template` | Make one version of your template everybody’s | Release my retro board template to the marketplace. |
| `super_project` | Create, read and edit projects | Put my three launch pages in a project called Launch, in this order. |
| `super_share` | Give people access | Share the Q3 report with dana@example.com. |
| `super_comments` | Read and answer the comments on an artifact | Read the open comments on the launch page and answer them. |
| `super_signatures` | Ask people to sign an artifact | Ask Dana and Lee to sign the design agreement and tell me when they have. |
| `super_help` | How the tools fit together | How do projects and collections differ? |

You never call these yourself: you ask, and your agent picks the tool. Tool names from
before 29 September 2026 no longer work: a call answers `unknown_tool`, and `fix` names the
current tool when the old name was a rename.

Scripts call the same tools over the [REST API](https://pr-1797-stg.superartifacts.app/docs/reference/api.md).

## Resources

The server also lists MCP resources a client can read without a tool call, all under
`superartifacts://`:

| Address | Reads |
| --- | --- |
| `help/{topic}` | A help topic: tools, data, datamodel, templates, collections, projects or batch. |
| `artifact/{artifact}` | One of your artifacts: its versions, files and data declaration. |
| `artifact/{artifact}/{path}` | A text file of the published version. |
| `artifact/{artifact}/v/{version}/{path}` | A text file of one version. |
| `template/{slug}` | A template's build prompt. |

`resources/list` returns the help topics; artifacts are read by address. A read reaches
only what the matching tool can. Sizes are in [Limits](https://pr-1797-stg.superartifacts.app/docs/reference/limits.md).

## Every answer has the same shape

What a tool sends back to your agent:

```json
{ "ok": true, "next": [{ "tool": "super_artifacts", "args": {}, "why": "…" }] }
{ "ok": false, "code": "invalid_arguments", "message": "…", "fix": "…", "accepts": ["…"] }
```

`ok` says whether it worked. When it did not, `code` names the problem
([Error codes](https://pr-1797-stg.superartifacts.app/docs/reference/errors.md)), `message` explains it, `fix` says what to change and
`accepts` lists the arguments the tool takes. When it did, `next` suggests the likely next
step. Your agent reads all of this, so a refusal is something it can act on.

## Timeouts

A call that has not answered after 55 seconds comes back as `mcp_timeout`. It may still
finish. Reading is safe to repeat; a change, such as a publish, may already have happened,
so have your agent check before it tries again, or the page is published twice:

**After a timeout**

```prompt
That Super Artifacts call timed out. Before you try again, check with super_artifacts whether it already happened, and only redo it if it did not.
```