How to Use the GetStream MCP in Windsurf

Let Windsurf's Cascade agent build and manage entire social feeds on GetStream while you watch.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GetStream MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Feed Management

This MCP Server connects Windsurf to GetStream's feed infrastructure. Just tell Cascade a high-level goal, like "Post this announcement and make sure all new hires see it." It's smart enough to chain the tools together on its own. Cascade will plan the steps: maybe it uses `upload_image` for a graphic, then `add_activity_to_feed` to post it, and finally `batch_follow` to subscribe a list of users to the right feed. You don't prompt each step. You give a goal, it delivers the result.

Build Social Features with Cascade

Stop building social features from scratch. Connect this server and let your agent handle the backend calls. You can ask Cascade to build a feature that lets users save posts for later. It knows how to use the GetStream tools to get the job done. It will figure out the sequence on its own, chaining `get_activities` to find a post and `add_to_collection` to save it to a user's "favorites" list. It can even handle media, using `get_open_graph` to pull a preview from a link in a post. All without you writing a single API call.

Manage Content and Users

Use your agent to handle day-to-day content moderation and user management. If a post is causing problems, tell Cascade, "Remove the last activity from the main announcements feed." It will use `remove_activity_from_feed` to take it down instantly. Need to clean up test data? Just ask. Cascade can `batch_delete_collections` or `unfollow_feed` to reset accounts. It's like having a junior dev who knows the entire GetStream API and never gets tired.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "getstream-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 GetStream. 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 GetStream 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 GetStream MCP in Windsurf

Cascade is an autonomous agent. When you connect this GetStream MCP Server, Cascade reads the manifest of all 23 tools, understands what each one does, and plans multi-step sequences to achieve your goals.

Yes. You can tell Cascade something like "Upload this logo and resize it for a profile picture." It will automatically use the `upload_image` and `process_image` tools to handle it.

Just give Cascade a list of user IDs and the target feed. It will recognize the task and use the `batch_follow` tool, which is much more efficient than following one by one.

Yes. You connect your GetStream API keys to the MCP Server once in the Vinkius dashboard. Windsurf then communicates with the server, so your keys are never exposed on your local machine.

Your agent only touches the data needed for a task, like activity payloads or user follow lists. All operations run through Vinkius's zero-trust sandbox, and the connection between Windsurf and the server is ephemeral. Your GetStream credentials stay on the server, not in your IDE.

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