How to Use the Gelato MCP in Windsurf

Q: How do I install the Gelato MCP Server in Windsurf?

Edit your /.codeium/windsurf/mcpconfig.json file to include the server details. You can also use the built-in MCP Marketplace for a one-click installation.

Q: Can Windsurf and Gelato handle multi-item orders?

Yes. Cascade passes multiple product IDs from listcatalogproducts into a single getshippingquote request. It calculates the combined fulfillment cost instantly.

Q: How does Cascade verify my Gelato API connection?

The agent runs verifyapiconnection immediately upon connection. If the token is invalid, it prompts you to update your environment variables before attempting any order operations.

Q: What happens if Windsurf submits a bad Gelato order?

You instruct Cascade to run cancelprintorder immediately. The agent requires the specific order ID to execute the cancellation.

Q: Does this MCP connection expose my customer shipping addresses?

The createprintorder tool transmits physical delivery addresses and design URLs to Gelato. Vinkius runs this MCP Server in an isolated V8 sandbox, destroying the environment after the execution finishes to prevent data leakage.

Connect Windsurf to Gelato and let Cascade automate your print-on-demand fulfillment.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gelato MCP to Windsurf

Create your Vinkius account to connect Gelato to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Gelato with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Browse Catalogs and Price Shipping via MCP Server

The `list_product_catalogs` and `list_catalog_products` tools allow Cascade to scan available print-on-demand inventory directly inside Windsurf. Instead of manually checking the Gelato dashboard, your AI client pulls exact product IDs and metadata using `get_product_details`. Once it finds the right mug or poster, Cascade chains that data into `get_shipping_quote`. You define the target margin, and the agent calculates the exact fulfillment cost for specific delivery addresses before writing a single line of checkout logic.

Autonomous Print Order Execution

Triggering `create_print_order` submits a new fulfillment request to Gelato without leaving your editor. Cascade maps the design URLs, quantities, and customer shipping details into the correct payload format automatically. If a user requests a cancellation window, the agent holds the order ID and executes `cancel_print_order` if conditions change. You skip the API documentation entirely because Windsurf already knows the exact schema required to process the transaction.

Track Shipments and Configure Webhooks

Calling `get_order_status` returns the current production phase of any item. When you need to build a customer-facing tracking page, Cascade uses `get_order_shipments` to pull carrier details and tracking numbers directly into your codebase. For event-driven architectures, the `list_print_webhooks` tool exposes your current event subscriptions. Cascade reads these configurations to write the exact endpoint handlers you need to process incoming Gelato status updates.

Setup guide

Set up Gelato MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Gelato MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Gelato payment history." If connected, Cascade will call the Gelato tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "gelato-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gelato. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Gelato now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Gelato MCP in Windsurf

Edit your `~/.codeium/windsurf/mcp_config.json` file to include the server details. You can also use the built-in MCP Marketplace for a one-click installation.

Yes. Cascade passes multiple product IDs from `list_catalog_products` into a single `get_shipping_quote` request. It calculates the combined fulfillment cost instantly.

The agent runs `verify_api_connection` immediately upon connection. If the token is invalid, it prompts you to update your environment variables before attempting any order operations.

You instruct Cascade to run `cancel_print_order` immediately. The agent requires the specific order ID to execute the cancellation.

The `create_print_order` tool transmits physical delivery addresses and design URLs to Gelato. Vinkius runs this MCP Server in an isolated V8 sandbox, destroying the environment after the execution finishes to prevent data leakage.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript