# Your ChatGPT or Claude can't see Instagram or TikTok. Connect StoriesFly and it can.

Ask it to vet an influencer, break down a competitor or find what works in your TikTok niche. It pulls live numbers from public accounts and gives you the analysis right in the chat. MCP is the standard way to plug a tool into an AI assistant. You paste one address, no code.

- 100 free requests
- Sign in with Telegram. No card.
- Instagram and TikTok in one connection
- Public accounts only
- One profile analysis ≈ 10 requests
- Server address: `https://storiesfly.com/mcp`

## Influencer check (example chat · sample numbers)

> Is @glow.with.ava a good fit for our skincare launch? Check engagement, how often she posts and whether the comments look real.

Tools called: `user_profile` (@glow.with.ava), `user_posts` (last 24 posts), `user_reels` (latest reels), `post_comments` (top 3 posts).

Here is what her public account shows right now:

|   | Value | Note |
| --- | --- | --- |
| Followers | 48.2K | public, following 612 |
| Engagement rate | 3.4% | likes + comments ÷ followers, last 24 posts |
| Posting cadence | 4.1 / week | steady, no gaps over 6 days |
| Top post | 212K views | reel “5-step morning routine” |

Comment quality: most are real questions about products and skin type. About 6% are emoji-only or look automated, which is normal for this size.

**Verdict:** Good fit. Ask for story reach screenshots before you sign, and brief her on a reel, her strongest format.

## Same question, two different answers

> How is @competitor doing on Instagram this month?

### Without StoriesFly

I can't open Instagram, so I can't see @competitor's current followers, posts or engagement.

What I know about them may be months old. You could check the profile yourself and paste the numbers here.

### With StoriesFly

@competitor posted 14 times in the last 30 days, mostly reels. Engagement is 2.1%, down from 2.8% the month before.

Their best post is a giveaway reel with 3.4K comments. Without giveaways, comments per post fell by a third.

## What you can ask in the chat

Write the way you would to a colleague. The assistant picks what to fetch and does the math.

### Check an influencer before an ad deal (Instagram)

Engagement, posting rhythm, sudden jumps and comment quality, with a clear yes or no.

> Check @creator before we pay for a post: is engagement steady, any sudden jumps, do the comments look real?

### Break down a competitor (Instagram)

What they post, how often, and which posts work best for them.

> What did @competitor post in the last 90 days, and what do their top 5 posts have in common?

### Audit your own profile (Instagram)

Your best and worst posts, and what sets them apart from accounts like yours.

> Which of my posts did best in the last 90 days, and how are they different from @peer1 and @peer2?

### See what works in a TikTok niche (TikTok)

Which videos of your competitors take off, compared with their usual numbers.

> For these 10 TikTok accounts, show the videos from the last 30 days that got 5 times their usual views.

### See who an account followed recently (Instagram + TikTok)

The accounts a brand or creator follows on Instagram or TikTok: partners, hires, collabs in the making.

> Who has @brand started following lately? Group them into creators, brands and everyone else.

## Everything public, by username or link

These are the tools your assistant sees. It calls them on its own when your question needs them.

### Instagram

| Tool | What it returns |
| --- | --- |
| `user_profile` | The public profile of an Instagram account |
| `user_posts` | An account's posts and reels, newest first, a page at a time |
| `user_reels` | An account's reels, newest first, a page at a time |
| `user_stories` | The stories an account has up right now, with the media link, time and duration of each |
| `user_highlights` | An account's highlights |
| `story_highlight` | One highlight by its id or link |
| `post_info` | One post or reel in full |
| `post_comments` | The comments on a post, a page at a time |
| `post_likers` | Accounts that liked a post |
| `user_followers` | The accounts that follow an account, a page at a time |
| `user_following` | The accounts an account follows, a page at a time |
| `search_users` | Finds accounts by name or username (q), a page at a time |
| `hashtag_info` | A hashtag's id, name and how many posts use it |
| `hashtag_posts` | Posts under a hashtag, a page at a time |
| `search_reels` | Finds reels for a text (q) |

### TikTok

| Tool | What it returns |
| --- | --- |
| `tiktok_video` | One TikTok video or photo post by its link (short vm.tiktok.com links too) |
| `tiktok_user_profile` | A TikTok account's profile by username |
| `tiktok_user_videos` | A TikTok account's videos, newest first, a page at a time |
| `tiktok_user_stories` | The stories a TikTok account has up now, by username |
| `tiktok_user_followers` | The accounts that follow a TikTok account, a page at a time |
| `tiktok_user_following` | The accounts a TikTok account follows, a page at a time, with the same fields as its followers |
| `tiktok_user_reposts` | The videos a TikTok account has reposted, newest repost first, a page at a time |

### Both, and your account

| Tool | What it returns |
| --- | --- |
| `download_media` | The files of one post by its link |
| `account_status` | How many requests are left |

## Who uses it, and for what

Real tasks with a prompt to copy and roughly how many requests each one takes. A request is one call, or one page of a list.

### SMM managers and agencies

Client work, every week.

| Task | Prompt | Requests |
| --- | --- | --- |
| Client audit | Audit @client's Instagram for the last 90 days: posting cadence, engagement rate, top 5 posts and what they have in common. | ≈ 10 requests |
| Monthly report | Make a monthly report for @client: posts this month, average likes and comments, best and worst post, one idea for next month. | ≈ 4 requests |
| Influencer check before an ad deal | Check @creator before we pay for a post: is engagement steady, any sudden jumps, do the comments look real? | ≈ 10 requests |
| Fake-follower check | Take a sample of @creator's followers and tell me how many look like empty or bot accounts. | ≈ 5 requests |
| Competitor comparison | Compare @a, @b and @c: how often they post, engagement, and the top 3 posts of each in the last 90 days. | ≈ 15 requests |

### Brands and online shops

Competitors, customers and launches.

| Task | Prompt | Requests |
| --- | --- | --- |
| Competitor tracking | What did @competitor post this week? Which post got the most comments, and what are people asking? | ≈ 4 requests |
| Customer posts under your hashtag | Find recent posts under #ourbrand and list the ones that show our product, with links. | ≈ 4 requests |
| Launch monitoring | We launched on Monday. Read the comments under our last 3 posts and sum up the questions and complaints. | ≈ 7 requests |

### Creators

Your own account, measured.

| Task | Prompt | Requests |
| --- | --- | --- |
| Own profile audit | Which of my posts did best in the last 90 days, and how are they different from @peer1 and @peer2? | ≈ 12 requests |
| Best time to post | Look at my last 60 posts: on which days and hours do they get the most likes and comments? | ≈ 6 requests |
| Formats that grow | Reels, carousels or photos: which format gets me the most views and comments this year? | ≈ 6 requests |

### TikTok niche research, every day

A morning routine for creators and agencies: ≈ 300 requests a month for 10 accounts, so it runs on prepaid balance.

| Task | Prompt | Requests |
| --- | --- | --- |
| Which competitor videos took off | Every morning: check the latest videos of these 10 TikTok accounts and show the ones doing better than usual. | ≈ 10 requests a day |
| Outliers against an account's own baseline | For @a, @b and @c, find the videos of the last 30 days with 5 times their usual views, and what they have in common. | ≈ 12 requests |
| Who the fast-growing accounts follow | Who do the 5 fastest-growing accounts in my niche follow? List the accounts they have in common. | ≈ 25 requests |
| What creators repost | What did @creator repost this month, and which topics keep coming up? | ≈ 3 requests |

### Talent managers and creator recruiters

Finding and checking creators.

| Task | Prompt | Requests |
| --- | --- | --- |
| Shortlist for a campaign | Find 20 home-fitness creators on Instagram, check their last posts and sort them by engagement. | ≈ 42 requests |
| Roster overview | For my 8 creators, put followers, engagement and posts per week in one table. | ≈ 16 requests |

### Researchers and journalists

Working with public accounts.

| Task | Prompt | Requests |
| --- | --- | --- |
| What people say under posts | What do people write under the last 10 posts of @brand? Which complaints repeat? | ≈ 21 requests |
| A public account's week | List what @official_account posted this week, with dates, captions and links. | ≈ 2 requests |
| A hashtag's reach | How many posts use #topic, and what do the top posts say? | ≈ 3 requests |

### Small businesses

The shop down the street, checked in a minute.

| Task | Prompt | Requests |
| --- | --- | --- |
| Local competitors | Compare our café @ours with @cafe_a and @cafe_b: what they post, how often, and what gets the most comments. | ≈ 9 requests |
| Today's offers | Show the stories @cafe_a has up right now and the offers they mention. | ≈ 1 request |

Light use fits a plan: Basic covers about 10 profile analyses a month, Pro about 50 profile analyses.

Daily niche monitoring and agency work run on prepaid balance: no monthly cap, pay per request, and the balance never expires. $10 buys 6,666 requests at $1.50 per 1,000, about 666 profile analyses.

## Connect in about a minute

One address works everywhere. In ChatGPT, Claude and Cursor you sign in with Telegram; no key to copy.

### ChatGPT

1. In ChatGPT, open **Plugins**, then **Add**, then **Add custom MCP server**.
2. Paste the address below and pick **OAuth** for sign-in.
3. Press Connect and sign in with Telegram on the StoriesFly page.
4. Ask about any public account: “Check @creator before an ad deal”.

```text
https://storiesfly.com/mcp
```

### Claude

1. In Claude, open **Customize**, then **Connectors**, then **Add custom connector**.
2. Name it StoriesFly and paste the address below.
3. Press Connect and sign in with Telegram on the StoriesFly page.
4. Ask about any public account in a new chat.

```text
https://storiesfly.com/mcp
```

The Free plan of Claude allows one custom connector.

### Claude Code

1. Run the command below.
2. In Claude Code, type `/mcp`, pick storiesfly and sign in with Telegram.

```bash
claude mcp add --transport http storiesfly https://storiesfly.com/mcp
```

### Cursor

1. Add StoriesFly to `mcp.json` (in Cursor's MCP settings, or `~/.cursor/mcp.json`).
2. Cursor shows StoriesFly under MCP: press Connect and sign in with Telegram.

```json
{
  "mcpServers": {
    "storiesfly": {
      "url": "https://storiesfly.com/mcp"
    }
  }
}
```

### Other clients

1. Create an API key in the **API dashboard** (sign in with Telegram).
2. Add the server address and send the key as a Bearer token.

```text
https://storiesfly.com/mcp
Authorization: Bearer <API key>
```

## Plans for every amount of work

Basic and Pro are the whole StoriesFly subscription: anonymous stories, downloads, follower tracking and alerts in the app, with requests for ChatGPT and Claude included. One profile analysis takes ≈ 10 requests.

| Plan | Price | Requests | Profile analyses | Good to know |
| --- | --- | --- | --- | --- |
| Free | $0 to try it | 100 requests once | ≈ 10 profile analyses | Once per Telegram account; Shared with the API; No card |
| Basic | $4.99 a month | The full app + 100 requests a month for AI | ≈ 10 profile analyses | Unlimited anonymous stories and downloads; Follower and unfollow tracking on Instagram and TikTok; Story alerts in Telegram; AI profile insights in the app |
| Pro | $19.99 a month | The full app + 500 requests a month for AI | ≈ 50 profile analyses | Everything in Basic; Track more accounts at once; Unlimited AI reports on any profile; Expired stories you can still open |
| Prepaid balance | $1.50 per 1,000 requests | From $10, pay per request | ≈ 666 profile analyses for $10 | No monthly cap; $10 buys 6,666 requests; The balance never expires; Best for daily TikTok niche work and agencies |

Try it free → Basic or Pro for everyday use → Prepaid balance for daily niche work and agencies. If you go over your plan, add balance and keep going.

## Questions people ask

### What does MCP mean, in plain words?

MCP (Model Context Protocol) is the standard way to plug a tool into an AI assistant such as ChatGPT or Claude. You add StoriesFly's address once. After that, when your question is about an Instagram or TikTok account, the assistant asks StoriesFly for the live public data and works with it.

### What does the assistant see?

Only what the tools return: public profiles, posts, reels, stories, highlights, comments, likes, followers and following, hashtags and search on Instagram, and profiles, videos, stories, followers, following and reposts on TikTok. About you it learns only how many requests you have left.

### Can it read private accounts?

No. Only public accounts. When an account is private, the assistant tells you so; that look-up counts as one request.

### Is the account owner notified?

No. The person is not notified: you never log in to Instagram or TikTok with your own account, and your own account never appears among the story's viewers.

### What happens when I reach the limit?

The assistant tells you the requests are used up and gives you the options with links: Basic, Pro or adding balance. A call that was not made is not charged. If you have balance and paying from it is on (it is on by default), the assistant keeps going on your balance.

### Why do I sign in with Telegram?

StoriesFly accounts live in Telegram: the same sign-in as the website and the bot. It takes one tap, needs no password, and keeps the free requests to one set per person. StoriesFly never sees your Telegram messages.

### Can I use it without a subscription?

Yes. The 100 requests free need only a Telegram sign-in. After that, add prepaid balance from $10 and pay per request, with no subscription.

### Does it cover Instagram and TikTok both?

Yes. One connection covers both. Ask about an Instagram account and a TikTok account in the same chat, and the assistant compares them.

## Your first 100 requests are on us

Paste one address into ChatGPT or Claude, sign in with Telegram, and ask about any public Instagram or TikTok account.

- [Connect now](https://storiesfly.com/developers/mcp#connect)
- [Open the dashboard](https://storiesfly.com/developers/dashboard)

## Links

- [This page on the site](https://storiesfly.com/developers/mcp)
- [Plans and prices](https://storiesfly.com/pricing): Basic and Pro
- [Instagram data API](https://storiesfly.com/developers): what the API is and what it returns
- [Pricing](https://storiesfly.com/developers/pricing): rates, examples and billing rules
- [Documentation](https://storiesfly.com/developers/docs): quick start, authentication, errors and every endpoint
- [OpenAPI file](https://storiesfly.com/openapi.json): the whole API in one file
- [API dashboard](https://storiesfly.com/developers/dashboard): get a key and top up
- [Changelog](https://storiesfly.com/developers/changelog): what changed and when