SNAPSBREW docs
Browse the docs Open

MCP server

let your assistant place the order

Snapsbrew speaks the Model Context Protocol, so any MCP client (Claude, Cursor, your own agent) can talk to your account directly. The assistant can browse your templates, preview a snap for free, and render the final image once you say yes. It uses the same API token as the rest of the API, and it works the moment you point a client at the server.

Previews are free and watermarked. Only create-snap spends a credit, and only after you approve a preview. Nothing is billed by surprise.

Connect

Endpoint https://snapsbrew.com/mcp
Transport Streamable HTTP
Auth Bearer token with the api_requests ability. The same key you use for the REST API.
Rate limit 30 requests per minute.

Most clients take a name, a URL, and a header. Here is the shape of a typical config: 

{
  "mcpServers": {
    "snapsbrew": {
      "url": "https://snapsbrew.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

How a render goes

The server nudges the assistant toward the same habit every time: look before you spend. A typical run goes like this.

  1. 1.whoami confirms the token works and reads the credit balance.
  2. 2.list-templates finds a template and its id.
  3. 3.get-template-details reads the layer keys to override.
  4. 4.preview-snap renders a free, watermarked preview. Iterate here until it looks right.
  5. 5.create-snap spends 1 credit and returns the clean, final image, once you approve.

Tools

Tool Cost What it does
whoami Free Returns your account and the credits left this period.
list-templates Free Lists your templates with their ids, sizes, and editable layers.
get-template-details Free Returns one template's layer keys and the overrides each layer accepts.
list-variant-properties Free The full catalog of overrides you can apply in variants, with value types and examples.
preview-template Free Renders a watermarked preview of a template, with optional overrides.
preview-snap Free Renders a watermarked preview of the snap you are about to create.
create-snap 1 credit Renders the final, un-watermarked snap and charges 1 credit.
describe-layers Free The layer object shape and property vocabulary for building or editing templates.
create-template Free Creates a new template from a title, dimensions, and layers.
edit-template Free Updates a template you own. Existing snaps depend on it, so use it deliberately.

Overrides

You customize a snap by passing variants: an array of objects, each one targeting a layer by its key with a single change. 

[
  { "layer": "headline", "text": "Summer sale" },
  { "layer": "logo", "image_url": "https://example.com/logo.png" },
  { "layer": "backdrop", "background_color": "#ff5a36" },
  { "layer": "ticket", "qr_content": "https://example.com/rsvp" },
  { "layer": "ribbon", "hidden": true }
]

Run list-variant-properties for the full override catalog, and get-template-details for the layer keys on a specific template.