How to Use the Gorgias MCP in Vercel AI SDK

Stream real-time Gorgias support data directly into your AI-SDK interface. Build interfaces that show tickets as they happen.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gorgias MCP to Vercel AI SDK

Create your Vinkius account to connect Gorgias to Vercel AI SDK 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 Gorgias with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live ticket streaming in AI-SDK

Your AI-SDK frontend renders customer interactions as they arrive. You use `list_tickets` to pull active queues and `get_ticket` to fetch details without page refreshes. The data flows through your edge functions. Your users see the support state update live, removing the need for static loading indicators.

Instant support actions

Trigger responses directly from your UI components. When an agent needs to reply, `create_message` pushes the content back to the platform instantly. You keep the conversation context tight. Every message sent via `create_message` appears in the customer thread immediately.

Manage customer profiles

Update user data while your AI client remains in the flow. Use `update_customer` to adjust contact details based on recent chat interactions. Your app handles the logic while the MCP server maintains the record. You get full control over customer data without leaving your environment.

Setup guide

Set up Gorgias MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Gorgias tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Gorgias transactions",
});

console.log(text);
await mcpClient.close();

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 Gorgias. 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 Gorgias 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 Gorgias MCP in Vercel AI SDK

You initialize the client via the provided endpoint. Just call `createMCPClient` with the server URL and pass the tools into your `streamText` configuration.

The server manages the communication layer, but you should implement standard retry logic in your requests. Monitor the response headers to ensure you stay within your API quota.

Yes, you can map the tool outputs to your own UI components. It's a direct bridge between your support data and your custom interface.

All requests use your specific endpoint token. The data remains scoped to your session and is never stored by the transport layer.

The server exposes 12 distinct tools. You can touch ticket contents, customer profiles, and user details as needed for your specific view.

Use it with your favorite AI tools

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

OpenAI Agents SDK sdk-python