MCP Artifact Tools

Tools for managing artifacts generated by skill executions.

list-artifacts

List your generated artifacts with pagination support.

Parameters

Example

{
  "tool": "list-artifacts",
  "arguments": {
    "limit": 10
  }
}

Response

{
  "success": true,
  "data": [
    {
      "id": 123,
      "skillSlug": "readme-generator",
      "skillName": "README Generator",
      "title": "README.md",
      "createdAt": "2024-01-15T10:31:30.000Z"
    },
    {
      "id": 122,
      "skillSlug": "code-generator",
      "skillName": "Code Generator",
      "title": "API Client",
      "createdAt": "2024-01-14T15:20:00.000Z"
    }
  ],
  "pagination": { "cursor": "122", "hasMore": true }
}

get-artifact

Get artifact content or download URL. Text under 100KB returns inline.

Parameters

Example

{
  "tool": "get-artifact",
  "arguments": {
    "id": 123,
    "filePath": "src/main.ts"
  }
}

Response

{
  "success": true,
  "data": {
    "id": 123,
    "title": "README.md",
    "fileType": "text/markdown",
    "content": "# My Project\n\nThis is a sample README.",
    "downloadUrl": "/api/v1/artifacts/123/download"
  }
}

download-artifact

Get a direct download URL for an artifact.

Parameters

Example

{
  "tool": "download-artifact",
  "arguments": {
    "id": 123
  }
}

Response

{
  "success": true,
  "data": {
    "id": 123,
    "title": "README.md",
    "fileType": "text/markdown",
    "downloadUrl": "https://clanker.net/api/v1/artifacts/123/download"
  }
}

Using the Download URL

The download URL requires authentication:

curl -O "https://clanker.net/api/v1/artifacts/123/download" \
  -H "x-auth-token: YOUR_AUTH_TOKEN"

Or with API key:

curl -O "https://clanker.net/api/v1/artifacts/123/download" \
  -H "x-api-key: YOUR_API_KEY"

delete-artifact

Permanently delete an artifact from your library.

Parameters

Example

{
  "tool": "delete-artifact",
  "arguments": {
    "id": 123
  }
}

Response

{
  "success": true,
  "data": {
    "message": "Deleted artifact \"README.md\"",
    "artifact": {
      "id": 123,
      "title": "README.md"
    }
  }
}

Errors

Warning: Deletion is permanent. Artifacts cannot be recovered.

Artifact Workflows

Finding a Previous Output

User: "Find that API documentation I generated last week"