# Curator.io MCP MCP

> Curator.io equips your AI agent to handle complex social media tasks. It lets you monitor content from multiple platforms, check the status of various feeds, and audit exactly what sources are contributing data. If you need to manage large-scale social aggregation or audit compliance rules across different accounts, this MCP handles it all.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** social-aggregator, content-curation, feed-management, digital-displays, social-feeds, marketing-tools

## Description

Curator.io connects your AI workflow directly to a modern social media aggregator. Instead of juggling platform dashboards, your agent manages your entire feed structure from one place. You can list and retrieve detailed settings for every aggregated source you use. Need to know what posts went up recently? Your agent monitors recent content across multiple feeds while giving you status and interaction details for each post. The system even lets you audit the active moderation rules applied to keep your content clean. Connecting this MCP via Vinkius means all these capabilities are available immediately through any compatible AI client, allowing your team to manage social aggregation strategy purely through conversation.

## Tools

### get_account_details
Retrieves usage limits and overall metadata for your Curator.io account.

### get_feed_details
Gets detailed settings, design information, and metadata for a specific social feed.

### get_feed_post_count
Returns the total number of posts currently aggregated in a specified feed.

### list_active_feeds
Quickly generates a list of all social feeds that are running and pulling data right now.

### list_social_connections
Lists all connected social media accounts (like Instagram, Twitter) authenticated with the service.

### list_social_feeds
Gets a complete roster of every configured social feed ID, name, and its current status.

### list_moderation_rules
Displays the current active keyword filters and exclusion patterns applied to content in a feed.

### list_feed_posts
Retrieves recent social media posts, including content, timestamps, and where they originated from.

### list_feed_sources
Lists all the specific social media sources (accounts or hashtags) connected to a given feed.

### search_posts_in_feed
Searches for specific social posts within a designated feed by entering a keyword or phrase.

## Prompt Examples

**Prompt:** 
```
List all active social feeds in my account.
```

**Response:** 
```
I've found 3 active feeds: 'Company Instagram', 'Event Hashtag #Tech2024', and 'Customer Testimonials'. Would you like to see the recent posts for any of these?
```

**Prompt:** 
```
Show me the last 5 posts from the 'Event Hashtag #Tech2024' feed.
```

**Response:** 
```
I've retrieved the last 5 posts for '#Tech2024'. They include 3 photos from Instagram and 2 tweets. One post from 'user_alpha' is trending with high engagement. Should I provide the source URLs?
```

**Prompt:** 
```
What are the social sources for my 'Company Instagram' feed?
```

**Response:** 
```
The 'Company Instagram' feed (ID: 456) is aggregating data from 2 sources: the official '@company_global' account and the '#WorkingAtCompany' hashtag. Would you like to check the moderation rules for these sources?
```

## Capabilities

### See and list all connected accounts
You can get a manifest of every single social media account (like Instagram or Twitter) that is currently linked to the system.

### Identify which feeds are running right now
The agent quickly shows you only the social feed channels that are actively pulling in new content.

### Review specific feed settings and metadata
You retrieve detailed configuration information, including moderation rules and design settings, for any particular feed channel.

### Audit the sources feeding a feed
It lists all the originating accounts or hashtags (like @company_global or #Tech2024) that are providing content to a specific feed.

### Search for posts by keyword in an aggregated feed
You can run targeted searches across thousands of social posts within a feed, pulling out only the content matching your keywords.

## Use Cases

### Auditing for brand safety compliance
A client needs to ensure no posts containing competitor names slip through. They prompt their agent, asking it to run `list_moderation_rules` and then confirm if a specific keyword is handled by the feed's active filters.

### Measuring campaign reach quickly
A marketing manager needs to know how much content was posted across all channels last week. They use `list_social_feeds` first, then run `get_feed_post_count` for each one to build a total metric.

### Investigating a specific topic's history
A content curator needs to find every mention of 'AI ethics' from the last six months. They use `search_posts_in_feed` on their main industry feed, getting all relevant posts regardless of posting date.

### Onboarding a new social channel
A digital strategist connects a new client account and immediately runs `list_social_connections` to verify the authentication state before configuring any feeds.

## Benefits

- You immediately know which accounts are connected by calling `list_social_connections`, eliminating the need to manually verify OAuth permissions across multiple platforms.
- Need a content count? Use `get_feed_post_count` to instantly get the total number of posts in any feed, perfect for quick daily status reports.
- When auditing compliance, simply calling `list_moderation_rules` shows you exactly what keywords are filtering out undesirable content before it reaches users.
- To track specific campaigns, your agent uses `search_posts_in_feed`, letting you find posts about 'Q3 earnings' even if they aren't the most recent ones.
- Understanding your data inputs is easy. Calling `list_feed_sources` tells you which accounts or hashtags are powering a feed so you know where to look next.

## How It Works

The bottom line is that your agent handles all the API calls; you just talk to it and get the answers.

1. First, connect this MCP to your AI client and authorize it using your Curator.io API Key.
2. Next, prompt your agent with a request—for example, 'What are the active feeds?' or 'Search for posts about Q3 reports.'
3. The system runs the required tool calls and returns structured data detailing feed status, post counts, or search results.

## Frequently Asked Questions

**How do I check which feeds are currently running using list_active_feeds?**
Calling `list_active_feeds` instantly shows you only the feeds that are actively pulling in new content. This saves time because you don't have to sift through inactive or paused channels.

**Can I find specific posts using search_posts_in_feed?**
Yes, `search_posts_in_feed` lets you find content by keyword within a feed. This is better than just looking at recent posts because it finds historical matches too.

**What does list_feed_sources tell me?**
`list_feed_sources` tells you the exact accounts or hashtags powering your feed. If content suddenly stops, checking these sources helps you know where to look for a connection failure.

**I need to check all my social media connections; which tool should I use?**
Use `list_social_connections`. This function gives you a full roster of every authenticated social account that the MCP can access, so you know your coverage area.

**How do I use `get_feed_details` to verify the configuration and metadata of a specific social media feed?**
It pulls up all detailed settings for that feed, including its design configurations and general metadata. You can audit everything from how it's set up to what rules apply.

**Before I run complex reports, how do I check my usage limits using `get_account_details`?**
This tool resolves your account identifiers and current usage boundaries. It’s essential for knowing if you've hit a quota or need to adjust your billing plan.

**What does `list_moderation_rules` show me about my feed's content filtering logic?**
It lists every active keyword filter and exclusion pattern set for the feed. This lets you check exactly what content gets blocked or flagged before it reaches your users.

**If I just need a quick metric, how do I get the total post count using `get_feed_post_count`?**
You get an immediate number representing the aggregate total of posts in a feed. It’s faster than listing all contents and perfect for simple reporting.

**How do I get a Curator.io API Key?**
Log in to your Curator.io account, go to **Settings > API**, and you will find your API Key there. Ensure you use the 'Secret Key' for integration.

**Can the agent delete posts from my feeds?**
This integration currently focuses on listing and retrieving feed and post data for analysis. Post deletion or moderation actions should be handled via the Curator.io dashboard.

**Which social platforms are supported?**
Curator.io supports aggregation from Instagram, Twitter, Facebook, LinkedIn, TikTok, YouTube, and many other social networks.