# GetStream MCP for AI Agents AI Agent Connect

> GetStream MCP for AI Agents. Build and manage scalable activity feeds and social networks. Let your agent handle follower relationships, feed updates, and media uploads directly. It gives you a way to orchestrate complex social architectures and activity feeds using plain language, making it easy to manage user engagement at scale.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_vcVyeOfRCZKbY1Rayhmqr5cHbaAg9iVKR7qzi2l2/ai-agent-connect
- **Tags:** activity-feeds, chat-api, social-infrastructure, real-time-sync, user-engagement, api-integration

## Description

GetStream is the Connector that lets you manage complex social architectures and activity feeds using natural language. You're probably spending way too much time jumping between different dashboards just to see if a feed is updating correctly or to check who's following a specific user. It's a chore that pulls you away from actual product work, forcing you to stay stuck in the weeds of manual data entry. With this GetStream MCP, you can just tell your agent to handle the heavy lifting. You can ask it to add an activity to a timeline, update a user's follower list, or even grab Open Graph data to make sure your links look right. It turns your social infrastructure into something you can manage through a conversation. Instead of hunting for the right button in a complex UI, you just describe the change you want to see. It's part of the Vinkius catalog, which makes it easy to plug into your existing workflow so you can focus on the big picture while the agent handles the granular social updates. This means you can move faster on social features without the headache of manual API calls or constant dashboard refreshes. You can oversee your entire social ecosystem from a single chat window, making it much easier to keep everything in sync as your user base grows.

## Tools

### add_activity_to_feed
This tool adds a new activity to a specific feed. It helps you keep your users updated with real-time content.

### add_to_collection
This tool adds an object to a specific collection. It makes it easy to group related items for better organization.

### batch_delete_collections
This tool deletes multiple collections in one batch. It saves time when you need to clean up large amounts of data.

### batch_follow
This tool lets you follow multiple feeds at once. It simplifies the process of building out complex social relationships.

### batch_get_collections
This tool retrieves multiple collections in a single request. It speeds up the way your agent pulls grouped data.

### batch_post_collections
This tool creates or updates multiple collections in a batch. It's great for bulk-managing your social infrastructure.

### delete_collection_object
This tool deletes a single object from a collection. It gives you precise control over individual items in your groups.

### delete_file
This tool deletes a file based on its URL. Use it to quickly remove content that is no longer needed.

### follow_feed
This tool makes one feed follow another. It allows you to build dynamic social connections between different feeds.

### get_activities
This tool fetches specific activities using an ID. It's perfect for looking up the details of a single post or event.

### get_collection_object
This tool retrieves a specific object from a collection. It lets your agent pull specific data points from a grouped set.

### get_open_graph
This tool scrapes Open Graph data from a web URL. It automatically enriches your activity content with metadata from external links.

### list_feed_followers
This tool lists which feeds are following a specific feed. It helps you understand your social graph and reach.

### list_feed_follows
This tool lists which feeds a specific feed is following. Use it to see what content your feed is currently prioritizing.

### partial_update_activity
This tool updates specific fields on an activity without rewriting the whole object. It prevents accidental data loss when you only want to change one detail.

### process_image
This tool resizes or processes images for your feed. It ensures your media looks consistent across different devices.

### remove_activity_from_feed
This tool removes an activity from a specific feed. It gives you a way to moderate content and keep feeds clean.

### unfollow_feed
This tool stops a feed from following another. It allows you to quickly prune social connections that are no longer relevant.

### update_activities
This tool updates the metadata for your activities. It ensures your activity details stay current as things change.

### update_collection_object
This tool updates a specific object inside a collection. It gives you granular control over grouped content.

### upload_file
This tool uploads a file to the service. It handles the heavy lifting of getting your data into the system.

### upload_image
This tool uploads an image to the service. It makes it easy to share rich media within your social feeds.

### get_feed
This tool pulls activities from a feed with pagination. It provides a reliable way to browse through all your recent content.

## Prompt Examples

**Prompt:** 
```
Show me the latest activities in the 'user' feed for user ID 'user_123'.
```

**Response:** 
```
I've retrieved the feed for 'user:user_123'. There are 10 recent activities, including a post about 'New Product Launch' and a photo upload. Would you like to see the details of the most recent one?
```

**Prompt:** 
```
Make the feed 'timeline:alice' follow 'user:bob'.
```

**Response:** 
```
Successfully executed the follow command. 'timeline:alice' is now following 'user:bob'. Future activities from Bob will now appear in Alice's timeline.
```

**Prompt:** 
```
Update activity ID 'act_999' to set the 'is_featured' field to true.
```

**Response:** 
```
I have partially updated activity 'act_999'. The 'is_featured' field is now set to true. All other metadata remains unchanged.
```

## Capabilities

### Add activities to specific feeds
Put new content into your user timelines or public feeds automatically.

### Update activity metadata without rewriting objects
Change specific fields on an activity without having to resubmit the entire data object.

### Manage follower and following relationships
Handle complex social graphs by creating and managing connections between different feeds.

### Upload and process images for feeds
Send media to the service and ensure it's resized or processed for the best display.

### Scrape Open Graph data from URLs
Automatically pull metadata from web links to enrich your activity content.

### Create and batch delete collections
Organize and manage grouped objects with bulk actions to save time on maintenance.

## Use Cases

### Checking feed health
A Product Manager needs to see if a feed is healthy and asks the agent to show the latest activities using get_feed.

### Testing follow logic
A Developer wants to test a new follow logic and asks the agent to make a timeline follow a specific user using follow_feed.

### Moderating content
A Community Manager needs to moderate a feed and asks the agent to remove a specific activity using remove_activity_from_feed.

### Enriching link metadata
A Content Creator wants to enrich a post and asks the agent to grab the Open Graph data for a link using get_open_graph.

## Benefits

- Manage social graphs without clicking through dashboards by using follow_feed and list_feed_followers to see who is following whom.
- Update specific activity details instantly with partial_update_activity, which prevents you from having to rewrite entire objects when changing one detail.
- Handle batch operations like batch_follow and batch_post_collections to manage large numbers of feeds and collections in a single request.
- Automate content enrichment by using get_open_graph to pull metadata from web URLs automatically for your feed activities.
- Simplify media management by using upload_image and process_image to handle your rich media experiences directly through your agent.
- Keep your feeds organized with collection tools like add_to_collection and batch_delete_collections to manage grouped objects easily.

## How It Works

The bottom line is you get a conversational interface for your entire social feed infrastructure.

1. Subscribe to this Connector on Vinkius.
2. Add your Stream API Key and JWT Token to your configuration.
3. Ask your agent to perform actions like following a feed or updating an activity.

## Frequently Asked Questions

**How can I manage my social feeds with an AI?**
You can use the GetStream MCP to give your AI agent direct access to your social infrastructure. This lets you perform actions like updating content, managing followers, and organizing feeds using natural language commands.

**Can GetStream help me automate my follower relationships?**
Yes, it can. By connecting this Connector, your agent can manage follower connections, follow new feeds, or unfollow others automatically based on your instructions.

**How do I use GetStream to update activity metadata?**
You can simply ask your agent to update specific parts of an activity. The Connector handles the request to change metadata without you having to manually edit the entire record.

**Is GetStream good for managing large social networks?**
It is designed specifically for that. It provides the tools needed to manage feeds, follow relationships, and large collections of data at scale.

**Can I use an AI agent to upload images to my feed?**
Yes, your agent can handle image uploads and even process them for your feed directly through the GetStream MCP integration.

**How does GetStream handle Open Graph data for my links?**
The Connector can scrape Open Graph data from any URL you provide. Your agent can then use that data to automatically enrich your feed activities with relevant information.

**Can I retrieve specific activities using their unique identifiers?**
Yes. Use the `get_activities` tool by providing a comma-separated list of activity IDs or foreign IDs to fetch their full metadata.

**How do I check which feeds a specific user is currently following?**
You can use the `list_feed_follows` tool. Provide the feed slug and user ID to get a comprehensive list of all target feeds being followed.

**Is it possible to update only a single field in an activity without sending the whole object?**
Absolutely. The `partial_update_activity` tool allows you to set or unset specific fields on an activity using a JSON payload, preserving the rest of the data.