How to Use the Gift Up! MCP in Windsurf

Q: What happens if a Gift Up! MCP Server request fails inside Windsurf?

Cascade handles the error gracefully. It runs verifyapiconnection to check if your API key is valid or if the service is down, then reports the exact error code directly in your chat sidebar.

Q: Is there a way to view all active gift cards inside this IDE?

You can ask Cascade to list them. It executes listactivegiftcards and lists the codes, balances, and expiration dates directly in your editor workspace.

Let Cascade in Windsurf autonomously verify balances, run redemptions, and track Gift Up! orders through chained tool calls.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gift Up! MCP to Windsurf

Create your Vinkius account to connect Gift Up! 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 Gift Up! with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-step automated redemptions with Cascade

This integration uses `validate_gift_card` to check if a customer's voucher is active before Cascade chains any further actions. Once verified, Cascade calculates the remaining balance and runs `redeem_gift_card` to process the exact payout. If the balance hits zero, the agent automatically triggers `redeem_gift_card_full` and logs the transaction. Because Cascade chains these tools together, you skip the back-and-forth prompt loops other IDEs force on you.

Windsurf handles complete order validation

This MCP Server exposes `find_order_by_ref` to let Windsurf instantly look up customer orders from raw text. You can feed a raw support ticket to Windsurf, and it will chain that search with `get_order_details` to pull the exact purchase history. Cascade reads the ticket context, runs the background checks, and displays the customer's active gift card codes. You don't have to bounce between browser tabs while a customer waits on chat.

Autonomous webhook and metadata sync

By running `list_gift_webhooks`, Cascade inspects your active endpoints and updates custom fields using this MCP integration. The agent uses the live context of your workspace to write the integration code and test it against your live Gift Up! account in one continuous execution path. You get a fully functional sync loop without writing boilerplate. Cascade handles the state transitions and runs `update_order_metadata` to keep your internal database updated.

Setup guide

Set up Gift Up! 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 Gift Up! 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 Gift Up! payment history." If connected, Cascade will call the Gift Up! tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "gift-up-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 Gift Up!. 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 Gift Up! 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 Gift Up! MCP in Windsurf

Cascade analyzes your prompt, determines that it needs to run `validate_gift_card` first, and then executes `redeem_gift_card` immediately after. It handles the outputs of one tool as inputs for the next without making you press run twice.

Yes. Just paste the reference code into Cascade and ask it to find the details. The agent runs `find_order_by_ref` and `get_order_details` to return the customer's full purchase record.

Cascade handles the error gracefully. It runs `verify_api_connection` to check if your API key is valid or if the service is down, then reports the exact error code directly in your chat sidebar.

You can ask Cascade to list them. It executes `list_active_gift_cards` and lists the codes, balances, and expiration dates directly in your editor workspace.

Your API keys are stored locally in your Windsurf configuration file and never sent to third-party servers. All operations involving gift card balances and customer order references are processed directly through secure, encrypted V8 sandboxes.

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