> ## Documentation Index
> Fetch the complete documentation index at: https://api.fanvue.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Example requests for the MCP server

> Plain-English requests to send through a client connected to the Fanvue MCP server, covering messages, posts, insights and agency work.

These are requests you can send, word for word or adapted, through a client connected to the [Fanvue MCP server](/docs/mcp-server). Each one is plain English. The client works out which tools to call, and every request works on any connected account except the agency ones, which need agency scopes.

## Messages

```text wrap title="Clear the inbox" theme={null}
Go through my unread chats, tell me who is waiting and what each fan wants, then draft a reply to every one. Show me the drafts before anything sends.
```

```text wrap title="Prioritise high-value fans" theme={null}
List the fans who have messaged me in the last 48 hours, ranked by how much they have spent, and draft a personal reply to my top 10.
```

```text wrap title="Follow up on unpaid offers" theme={null}
Find pay-to-view messages I sent in the last 7 days that have not been purchased, and draft a follow-up for each.
```

```text wrap title="Reward your top fans" theme={null}
Find my biggest spenders from the last 30 days, put them in a custom list, and send each one a personal message about tonight's drop.
```

```text wrap title="Message a smart list" theme={null}
Send a mass message to my active subscribers about Friday's drop, and show me the text before it goes.
```

## Posts and media

```text wrap title="Plan a week of posts" theme={null}
Draft three teaser posts for this week's drop, schedule them across the week, and pin the strongest one to my profile.
```

```text wrap title="Publish an image post" theme={null}
Post the photo at ~/Content/friday-drop.jpg as a $9.99 pay-to-view for my subscribers, write a caption that teases tonight's drop, and use friday-drop-teaser.jpg from the same folder as the free preview.
```

<Note>Publishing an image needs a client that can read files on your machine, such as an editor or terminal client.</Note>

```text wrap title="Find unposted content" theme={null}
Look in my "Campaign" vault folder and tell me which photos and videos I have not posted or sent yet, with a caption idea for each.
```

## Insights

```text wrap title="Know your numbers" theme={null}
Compare my earnings this week with last week, name my top five spenders, and suggest one thing I could do next week to grow.
```

```text wrap title="Spot your best content" theme={null}
Rank my posts from the last 30 days by tips and unlocks earned, with a short note on what the top ones had in common.
```

## Agency

These requests need agency scopes, so they work only on an agency account.

```text wrap title="Run the morning standup" theme={null}
For every creator I manage, give me a one-line status: unread messages, earnings today, and anything that needs me right now.
```

```text wrap title="Coach the team" theme={null}
Pull the chatter leaderboard for this week, tell me which team members are converting best, and flag any creator whose inbox is falling behind.
```

## What each request calls

The client chooses tools by matching each request to the API operations the server exposes. This is what each example reaches.

| Request | Tools called |
| - | - |
| Clear the inbox | Get unread chats, messages, and notifications count; Get list of chats; Get messages from a chat; Send a message |
| Prioritise high-value fans | Get list of chats; Get fan insights in bulk; Send a message |
| Follow up on unpaid offers | Get list of chats; Get messages from a chat; Send a message |
| Reward your top fans | Get top-spending fans; Create a custom list; Add members to a custom list; Send a message |
| Message a smart list | Get smart lists; Send a mass message |
| Plan a week of posts | Create a new post; Pin a post |
| Publish an image post | `custom__start-image-upload` (once per image); `custom__create-image-post` |
| Find unposted content | List vault folders; List media in folder; Get list of posts; Get list of chats |
| Know your numbers | Get earnings data; Get top-spending fans |
| Spot your best content | Get list of posts; Get tips for a post |
| Run the morning standup | Get agency creators; Get unread chats, messages, and notifications count for a creator; List per-creator-per-day earnings across all agency creators |
| Coach the team | Get chatter leaderboard; List chats across all agency creators |

## What cannot be requested

Dynamic lists live only on the `/v1/` API, which the server does not expose, so a request to build or message a dynamic list fails. Experience operations can't be authorised through the server, so requests about fan experiences fail too. [What is not exposed](/docs/mcp-server#what-is-not-exposed) has the reasons.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.