# Phyllo MCP

> Phyllo connects your AI client directly to live data from dozens of social networks. It pulls creator metrics, audience demographics, and campaign reach—all in one place. Use it to analyze influencer performance, track cross-platform growth, or verify accounts without manual API calls or scraping.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** creator-economy, influencer-statistics, instagram-metrics, tiktok-analytics, audience-verification

## Description

**Phyllo** connects your AI client straight to live data from dozens of social networks. You don't need to write a bunch of complex API scripts; you just let your agent talk to the server, and it pulls all that messy data for you. 

You can use this thing to analyze how well influencers are doing, track growth across platforms, or verify accounts without manual scraping or making calls yourself.

**Search for Creators**: You start by running `search_creators`. This tool lets you search for specific people across every social platform Phyllo supports, using keywords or filters. It's your starting point when you need to find potential partners quickly.

**Analyze Audience Demographics**: Need to know who the audience is? Use `get_creator_audience` to pull detailed demographic info about a creator’s base. You get specific data on their audience makeup, which helps you understand where they're at and who they talk to.

**Track Content Performance**: To see what content is actually working, run `get_creator_content`. This gets you the most recent posts, videos, or streams from a creator account. You get a list of their activity so you know what material's available for analysis.

**Measure Engagement Rates**: When you find a piece of content that looks promising—a post, video, or stream—you run `get_engagement_stats`. This tool pulls specific analytics metrics just for that one item. You get hard numbers on its performance.

**Verify Creator Status**: Before trusting any data, check the creator's credentials. Use `get_identity_status` to see if they’ve verified their real-world identity or account status with major providers. It confirms legitimacy.

**Platform and Profile Details**: You can pull a unified picture of any creator using `get_creator_profile`. This pulls core details across multiple social platforms for one person, giving you a holistic view. To see what networks Phyllo talks to, run `get_platform_list`. It lists every single social media platform available for data collection.

**Deeper Financial and Technical Checks**: Need more depth? You can fetch verified income streams linked to the creator's account with `get_account_income`. If you’re running automated reporting, check `get_webhook_status` to see the status and configuration of any registered webhooks attached to accounts. It makes sure your data flow stays live.

**Connecting Everything**: First, remember you gotta generate a secure token using `create_connect_session`—that authorizes the whole connection session. If you need to find creators by running a broad search, use `search_creators`. You can then get their full profile with `get_creator_profile`, check out who they're talking to via `get_creator_audience`, and see what kind of stuff they've posted using `get_creator_content`. For any single piece of content you want to grade, run `get_engagement_stats` for the metrics. If you need to confirm their identity or income streams, check `get_identity_status` and `get_account_income`, respectively. You can also verify how Phyllo is set up by checking `get_webhook_status` against the list of supported platforms from `get_platform_list`. This gives your agent everything it needs to run deep dives into creator performance across multiple networks.

## Tools

### create_connect_session
Generates a secure token needed to authorize the connection session.

### get_account_income
Fetches verified income streams that are linked to the creator's account.

### get_creator_audience
Retrieves detailed demographic information about a creator’s audience base.

### get_creator_content
Gets a list of the most recent posts, videos, or streams from a specific creator.

### get_creator_profile
Pulls a unified profile containing core details across multiple social platforms for one creator.

### get_engagement_stats
Retrieves specific engagement analytics metrics for any single post or piece of content.

### get_identity_status
Checks if the creator has verified their real-world identity status with major providers.

### get_platform_list
Lists every social media platform that Phyllo supports for data collection.

### get_webhook_status
Checks the status and configuration of any registered webhooks attached to accounts.

### search_creators
Searches for specific creators across all supported social platforms using keywords or filters.

## Prompt Examples

**Prompt:** 
```
Provide the complete 3-month growth insights for the creator linked to 'uid-9430'.
```

**Response:** 
```
Data fetched successfully. The creator at UID-9430 experienced a 14% overall growth this quarter aggregating platforms. TikTok subscriber acquisition was highest (adding 25k), while YouTube stalled out. Would you like a breakdown of post tags corresponding to the TikTok spike?
```

**Prompt:** 
```
List all active posts sponsored by brand XYZ published in the last 48 hours.
```

**Response:** 
```
Scanning campaign outputs... I found 6 affiliated posts across the network mentioning 'Brand XYZ'. 4 are Instagram reels combining for 120k views, and 2 are YouTube integration shorts at 85k views. Are we generating an Excel export of the raw interactions logged so far collectively?
```

**Prompt:** 
```
Rank our top 10 verified fitness creators based solely on Instagram comment-to-follower ratio.
```

**Response:** 
```
Applying ratio filter against your creator vault. At the top sits Creator ID 'fit-91', achieving an abnormally high 8% comment ratio despite their large base. Shall I present the entire ranked table mapping out all 10 profiles in markdown seamlessly?
```

## Capabilities

### Search for Creators
Find potential partners by running a search across all supported social platforms using `search_creators`.

### Analyze Audience Demographics
Retrieve detailed demographic information about a creator's audience base with `get_creator_audience`.

### Track Content Performance
Fetch recent posts, videos, or streams from a specific creator account using `get_creator_content`.

### Measure Engagement Rates
Get specific engagement analytics for any single piece of content using `get_engagement_stats`.

### Verify Creator Status
Check if a creator has verified their real-world identity or account status with `get_identity_status`.

## Use Cases

### Pitching an Influencer Client
An agency planner needs to build a pitch deck for a client. Instead of having to manually log into TikTok, YouTube, and Instagram to check growth, they prompt their agent: 'Give me the 3-month growth insights for Creator X.' The agent runs `get_creator_audience` and `get_creator_content`, compiling all metrics—TikTok spikes, overall growth percentage, etc.—into a single report.

### Monitoring Brand Sponsorships
A brand manager needs to check every sponsored post for 'Brand XYZ' in the last 48 hours. They prompt their agent, which executes tools like `get_engagement_stats` and filters content via `get_creator_content`. The result is a consolidated list of all posts and their combined views.

### Vetting New Partners
A platform admin needs to onboard a new creator. They use the agent to run multiple checks: first, `get_identity_status` to confirm real-world identity; second, `search_creators` to find their main handles; and finally, `get_creator_profile` for basic details. This confirms legitimacy instantly.

### Calculating Total Campaign Value
A marketer wants to know how much income a creator generates through various streams. They prompt the agent to run `get_account_income`. The tool returns verified, linked income data, which they can then cross-reference with engagement metrics from another call.

## Benefits

- Access live, verifiable data. Instead of relying on manual estimates, use `get_creator_audience` to query accurate demographics and historical subscriber growth models.
- Automate campaign tracking instantly. Correlate real-time engagement metrics across YouTube, TikTok, and Instagram using `get_engagement_stats`, saving you the tedious work of checking three different dashboards.
- Verify accounts without friction. Don't guess a creator's reach; use `get_identity_status` to confirm their verified status directly from major providers.
- Build comprehensive profiles fast. Use `get_creator_profile` and `search_creators` together. Your agent pulls the bio, location, and key metrics into one unified data set instantly.
- Streamline reporting. Get a full content history for any user using `get_creator_content`, allowing your AI to feed raw video metadata directly into reports.

## How It Works

The bottom line is, your AI client accesses authenticated creator data directly through specific endpoints, skipping manual scraping entirely.

1. Subscribe to the Phyllo server deployment.
2. Connect your AI client and input the provided Client/App secrets in the dashboard.
3. Tell your agent which data you need (e.g., 'What was the 3-month growth for Creator X?'). The agent executes the necessary tools and returns the compiled metrics.

## Frequently Asked Questions

**How do I check a creator’s overall profile using Phyllo?**
Use `get_creator_profile`. This tool pulls a unified view of the creator's core details across multiple platforms into one place. It saves you from visiting every single social media page.

**Can I track income using Phyllo?**
Yes, run `get_account_income`. This fetches verified income streams linked to the creator's account directly through the server tools. You won't have to manually collect revenue reports.

**Is `search_creators` limited by keywords?**
No, `search_creators` supports complex filtering across supported social platforms. You can use multiple criteria in a single query (e.g., 'fitness' AND 'US' AND 'TikTok').

**Does Phyllo help verify if an account is real?**
Yes, `get_identity_status` checks the creator’s status against major providers to confirm their verified identity. This helps prevent fraud before you commit to a partnership.

**Before I use any tool, how do I handle the initial setup using `create_connect_session`?**
You first call `create_connect_session` to generate a secure token. This token authorizes your AI client and ensures that subsequent calls—like fetching audience or content data—are properly authenticated.

**What specific metadata does the tool `get_creator_content` retrieve?**
`get_creator_content` pulls raw performance metadata from recent posts, videos, and streams across platforms. This allows your AI agent to ingest structured data for deep analysis, not just simple counts.

**How can I monitor real-time updates using `get_webhook_status`?**
This tool lets you check the active status and configuration of all registered webhooks. It ensures that when a creator posts something new, your AI client gets an immediate notification.

**What kind of demographic details does `get_creator_audience` provide?**
`get_creator_audience` delivers detailed demographics and historical subscriber growth models. You get accurate data on who the creator's audience is and how that base has changed over time.

**Can my AI automatically aggregate all engagement statistics across a specific creator's 3 linked socials?**
Yes! Utilize the `get_creator_identity` combined with `get_audience_metrics`. Your agent will ping Phyllo, mapping their YouTube, TikTok, and Instagram channels simultaneously to produce a single comprehensive metric report instantly.

**How do I easily discover what tier of influencers are trending within the beauty sector?**
Direct your agent to use the `search_creators` tool, filtering via the 'Beauty/Cosmetics' tag and sorting by active engagement. The agent returns ranked creator profiles dynamically bypassing manual research.

**Are there any destructive capabilities regarding a creator's linked accounts?**
No. The API calls are strictly read-only layers fetching authenticated analytical performance or demographic distributions, meaning you cannot post, alter profiles, or delete associations.