Docs menu
Docs/AI agents

Use Spritory from your AI agent

Connect your AI agent to Spritory and ask it for sprites, effects and palettes. It works through the same Forge you do, so everything it makes matches your game and lands in your library.

Spritory connects to agents through MCP, the Model Context Protocol. Any agent that supports remote MCP servers with a custom header can use it.

Pick your agent

Using another agent? Look for its remote or HTTP MCP setting and use the address and header below.

How to connect

  1. Get full access

    Agent access is part of full access. See pricing.

  2. Create a token

    Go to your billing page and find Agent access (MCP). Name the token, and click Create token. Copy it right away, because it is shown only once.

  3. Add Spritory to your agent

    Every agent needs the same two things:

    • The server address: https://spritory.com/api/mcp
    • A header: Authorization: Bearer spt_your_token

    The page for your agent shows exactly where they go.

  4. Ask for something

    Restart your agent if needed, then ask it to make an asset in Spritory.

Keep your token private

A token acts as your account. Do not commit it to a repository or paste it into shared chats. If one leaks, revoke it on your billing page and create a new one.

What your agent can do

  • Build sprites and effects. From a template or from scratch, in the palette and art style you choose.
  • Make small edits. Change only what you ask for, such as a color or a size. Nothing is redrawn from scratch.
  • Review its own work. Render previews and contact sheets to check a whole set before it finishes.
  • Vary and animate. Pick the best seed variant, add motion presets, or capture pose timelines.
  • Manage palettes. Create palettes, import one from Lospec, lock colors, or extract a palette from reference art.
  • Export files. Sprite sheets with an atlas, single PNGs, GIFs and more, delivered as download links.

Prompt ideas

  • "Make a dungeon prop set: a chest, a barrel, a torch and a door."
  • "Give the torch a flame effect and a gentle flicker."
  • "Try four seed variants of the bush and keep the best one."
  • "Create a palette from the art at this link and use it for everything."
  • "Recolor the sword with the metal slot and make the blade longer."
  • "Export every saved sprite as one sheet with an atlas."
Get better results

Ask your agent to render and review its work before it finishes, and to build sets in one go. Naming your palette and art style up front keeps a set consistent.

Good to know

Exports expire, your saves do not

Files your agent exports are download links that expire after 7 days. Your saves stay in your library, so you can export the same assets again at any time, from the editor or by asking your agent.

Rate limits

Agent requests are limited per minute. If your agent hits the limit, it will be told to wait a minute. Asking for work in larger batches helps.

Edits from several places

If a save changes while your agent is editing it, the agent reads the latest version and applies its change again, so it does not overwrite your work.

Managing tokens

Your billing page lists every token with when it was created and last used. Revoke any token you no longer need. Revoking takes effect immediately.

Troubleshooting

  • Unauthorized. The token is wrong, revoked or missing. Check that the header reads Authorization: Bearer followed by a space and the full token.
  • License message. If your agent reports that the account no longer has a Forge license, access has ended on that account. Check your billing page.
  • Agent asks you to sign in with OAuth. Spritory uses a token header, not an OAuth sign-in. Make sure your agent config includes the header, then restart the agent.
  • Tools do not appear. Restart the agent after changing its config, and check that the server address ends in /api/mcp.

Try it in the Forge

Open the editor for free and build along with this page.

Open the Forge