spriteship

Get export download command

get_export_command

Read-onlyIdempotent

Build the authenticated download URL + a ready-to-run curl line for a zip export (character engine bundle, asset bundle, or map bundle). Run the curl in your own shell — zips are multi-MB binaries and must not be passed through the model. Phaser character and asset exports may select size 512, 256, 128, or 64; the selected sheet/atlas pairs keep canonical size-agnostic filenames. Sparrow XML is character-only: preserve the bundle's Sparrow prefixes and multisparrow assetPath routing. This tool exports whole characters, not a dashboard single-animation selection. Requires SPRITESHIP_API_KEY to be set in that shell.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "target": "<target>",
      "entityId": "<entityId>",
      "engine": "<engine>"
    },
    "name": "get_export_command"
  }
}

Input Schema

Name	Required	Description
`size`	No	Phaser character and asset exports only — narrow the zip to one downscale variant. Godot, Unity, GameMaker, Unreal and Sparrow XML use full-resolution source frames; omit size for them.
`engine`	Yes	Target engine. "fnf" is characters only and emits Sparrow PNG/XML plus character JSON. "tiled" is maps only; sprites have no Tiled emitter. "unreal" is beta Paper2D artwork/flipbook import, not automatic gameplay or native-engine certification.
`target`	Yes	What to export.
`entityId`	Yes	Character id, asset id/slug, or map id.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 22, 2026

changedInput schema / properties / size / description

Previous value: -"Phaser character exports only — narrow the zip to one downscale variant. Godot, Unity, GameMaker, Unreal and Sparrow XML use full-resolution source frames; omit size for them."New value: +"Phaser character and asset exports only — narrow the zip to one downscale variant. Godot, Unity, GameMaker, Unreal and Sparrow XML use full-resolution source frames; omit size for them."

Changed3 schema fields changedSep 14, 2026

changedInput schema / properties / engine / description

Previous value: -"Target engine. \"tiled\" is maps only; sprites have no Tiled emitter. \"unreal\" is beta Paper2D artwork/flipbook import, not automatic gameplay or native-engine certification."New value: +"Target engine. \"fnf\" is characters only and emits Sparrow PNG/XML plus character JSON. \"tiled\" is maps only; sprites have no Tiled emitter. \"unreal\" is beta Paper2D artwork/flipbook import, not automatic gameplay or native-engine certification."

changedInput schema / properties / engine / enum

Previous value: -[
-  "phaser",
-  "godot",
-  "unity",
-  "gamemaker",
-  "unreal",
-  "tiled"
-]New value: +[
+  "phaser",
+  "godot",
+  "unity",
+  "gamemaker",
+  "fnf",
+  "unreal",
+  "tiled"
+]

changedInput schema / properties / size / description

Previous value: -"Phaser character exports only — narrow the zip to one downscale variant. Godot, Unity, GameMaker and Unreal use full-resolution source frames."New value: +"Phaser character exports only — narrow the zip to one downscale variant. Godot, Unity, GameMaker, Unreal and Sparrow XML use full-resolution source frames; omit size for them."

Changed3 schema fields changedSep 9, 2026

changedInput schema / properties / engine / description

Previous value: -"Target engine. \"tiled\" is maps only; sprites have no Tiled emitter."New value: +"Target engine. \"tiled\" is maps only; sprites have no Tiled emitter. \"unreal\" is beta Paper2D artwork/flipbook import, not automatic gameplay or native-engine certification."

changedInput schema / properties / engine / enum

Previous value: -[
-  "phaser",
-  "godot",
-  "unity",
-  "gamemaker",
-  "tiled"
-]New value: +[
+  "phaser",
+  "godot",
+  "unity",
+  "gamemaker",
+  "unreal",
+  "tiled"
+]

changedInput schema / properties / size / description

Previous value: -"Phaser character exports only — narrow the zip to one downscale variant. Godot, Unity, and GameMaker always use full-resolution source frames."New value: +"Phaser character exports only — narrow the zip to one downscale variant. Godot, Unity, GameMaker and Unreal use full-resolution source frames."

Changed1 schema field changedAug 20, 2026

changedInput schema / properties / size / description

Previous value: -"Characters only — narrow a phaser zip to one downscale variant."New value: +"Phaser character exports only — narrow the zip to one downscale variant. Godot, Unity, and GameMaker always use full-resolution source frames."

First observedAug 14, 2026

TDQS

A4.3/5.0

Behavior5/5

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

With annotations already declaring read-only, idempotent, open-world, and non-destructive behavior, the description adds important operational context: the shell must have SPRITESHIP_API_KEY, the download must happen outside the model, and size/Sparrow behaviors affect the export. It does not contradict the annotations.

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?

The description is front-loaded with the core action and the critical shell/binary constraint. It is dense but mostly earns its length by covering engine-specific nuances, though some size details overlap with the schema.

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?

Given the lack of an output schema and the tool's complexity, the description is complete enough: it explains the returned artifacts, authentication requirement, binary handling, engine restrictions, size behavior, and export scope.

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

Parameters4/5

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

Schema coverage is 100%, so all four parameters are documented in the input schema. The description still adds cross-parameter semantics beyond the schema, including Phaser-only size selection, Sparrow XML being character-only, canonical size-agnostic filenames, and multisparrow assetPath routing.

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

Purpose4/5

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

The description states a specific verb and resource: build an authenticated download URL plus curl command for a zip export, covering character, asset, and map bundles. It is clear what the tool does, but it does not explicitly distinguish itself from sibling command tools such as get_project_export_command or get_ui_pack_export_command.

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

Usage Guidelines4/5

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

It gives clear usage context: run the returned curl in your own shell because zips are multi-MB binaries and must not pass through the model. It also explains size selection and Sparrow XML applicability, though it does not name alternative tools or state when not to use this one.

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

All spriteship 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?