Mcp Server Gelato

Name: Mcp Server Gelato
Author: madzarm

@madzarm

Repository

About Mcp Server Gelato

Server for managing your Gelato POD account.

#mcp-server #gelato #print-on-demand

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-gelato": {
      "command": "uvx",
      "args": [
        "mcp-server-gelato"
      ],
      "env": {
        "GELATO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mcp Server Gelato?

Mcp Server Gelato integrates with Gelato’s print-on-demand API, providing tools and resources to search orders, retrieve order details, and explore product catalogs. It is designed for developers using AI assistants (MCP hosts) to manage Gelato order workflows and product data.

How to use Mcp Server Gelato?

Install via uvx mcp-server-gelato or pip install mcp-server-gelato, then set the GELATO_API_KEY environment variable. Run the server with mcp-server-gelato or add it to Claude Desktop using claude mcp add gelato --env GELATO_API_KEY="your_key" -- uvx mcp-server-gelato. After startup, use tools like search_orders and resources like orders://{order_id}.

Key features of Mcp Server Gelato

Search orders with multiple filters (status, country, date range)
Retrieve order summaries and detailed order information
Search products in catalogs with filtering capabilities
Check stock availability across regions
List available shipment methods
Clear separation between data resources and operational tools

Use cases of Mcp Server Gelato

Managing print-on-demand orders from an AI assistant
Exploring product catalogs and pricing for fulfillment planning
Checking stock and shipment methods before placing orders
Automating order status tracking and draft order management

FAQ from Mcp Server Gelato

How do I get a Gelato API key?

Visit the Gelato API Portal, sign up or log in, and generate an API key from your dashboard.

Do I need Python installed to use this server?

Yes, Python 3.13 or later is required.

What happens if the server starts without an API key?

The server will fail to connect. You can either install with the API key set as an environment variable or use the configure_gelato tool within Claude to configure it afterward.

What transports and authentication does this server use?

The server uses standard MCP transport over stdio and authenticates via a Gelato API key provided through the GELATO_API_KEY environment variable.

Are there any known limits?

The search_orders tool is limited to 100 results per request (controlled via the limit parameter). The server automatically retries on rate limiting with exponential backoff.