# Patreon MCP

> Patreon (Creator Subscriptions) MCP Server lets your AI agent manage everything related to your creator account. You can list active campaigns, check individual member details, track post history across all your content streams, and build real-time webhooks for instant updates on membership changes or posts going live.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** patreon, creator-economy, subscription-management, membership-tracking, content-creators

## Description

Look, this isn't some fancy dashboard you just glance at—this lets your AI agent actually *do* stuff with your creator account. You can connect it to any client, and suddenly, your agent knows how to manage everything from tracking down every single member right up through handling real-time alerts for new posts or folks joining up.

**Managing Your Campaigns and Accounts**

You gotta know what you're working with first. You can see a rundown of every campaign you own by running `list_campaigns`. If you need the deep dive on just one, use `get_campaign` to pull all those specific details using its ID. To quickly check your credentials and make sure everything's pointing right, run `get_identity`; that shows exactly who's logged in and what permissions they've got.

**Deep Dive into Your Memberships**

When it comes to your audience, you don't have to guess. You can pull a complete list of every member attached to an entire campaign using `list_campaign_members`. Need details on just one person? Use `get_member` and feed it their ID, and you get specific data points like their membership status or profile info. This is how your agent tracks who's paying attention and who might be slipping away.

**Tracking Your Content History**

Forget manually checking old posts. To keep track of all the content going out for a specific campaign, use `list_campaign_posts`. It pulls every single post associated with that campaign ID—the whole history, right there. If you need to check multiple campaigns' content streams, you just run this tool repeatedly against different IDs.

**Setting Up Real-Time Alerts (Webhooks)**

This is where the automation magic happens. You don't want to wait for a member join or a post publish notification; you wanna know *the second it happens*. Your agent manages that with webhooks. You set one up using `create_webhook` so your client gets instant pings when specific events fire, like someone joining or new content going live. If that webhook is giving you trouble, you can update its settings—like changing the URL or tweaking which event types it listens for—using `update_webhook`. When a hook isn't needed anymore, you clean it up fast with `delete_webhook`. And if you wanna see everything your agent has set up, run `list_webhooks`.

**Putting It All Together**

Your AI client runs this whole sequence naturally. You tell your agent something like, “Pull the member list for the 'VIP' campaign and check their last five posts.” The agent automatically executes `get_campaign`, then `list_campaign_members` followed by `list_campaign_posts`. It’s all done without you having to write a bunch of code or switch between tabs. You just talk, and your client does the heavy lifting across your entire creator business.

## Tools

### list_campaigns
Returns an overview and list of every campaign you own on Patreon.

### create_webhook
Sets up a new webhook notification for specific events like posts publishing or members joining.

### delete_webhook
Removes an existing, unnecessary webhook from your active list.

### get_campaign
Retrieves the full details for one specific Patreon campaign using its ID.

### get_member
Pulls detailed information for a single, specific member by their ID.

### get_identity
Shows who is currently logged in and what permissions your account has access to.

### list_campaign_members
Retrieves a full list of members associated with an entire campaign.

### list_campaign_posts
Gets a comprehensive list of all posts ever published under a specific campaign ID.

### update_webhook
Changes settings, like the URL or event types, for an existing webhook.

### list_webhooks
Lists all the webhooks that your agent or client has set up for tracking.

## Prompt Examples

**Prompt:** 
```
List all my Patreon campaigns.
```

**Response:** 
```
I've found your campaigns. You have one active campaign: 'Digital Art & Tutorials' (ID: 1234567). Would you like to see the member list or recent posts for this campaign?
```

**Prompt:** 
```
Show me the members for campaign ID 1234567.
```

**Response:** 
```
Fetching members for campaign 1234567... I found 150 active members. The most recent joiners include 'Alex Smith' and 'Jordan Doe'. Do you want details on a specific member?
```

**Prompt:** 
```
Who am I logged in as on Patreon?
```

**Response:** 
```
You are currently authenticated as 'CreativeStudio' (email: creator@example.com). Your profile is linked to 1 campaign.
```

## Capabilities

### Track Member Lists
Fetch a list of subscribers for any specific Patreon campaign using `list_campaign_members`.

### Monitor Post History
Retrieve every post associated with an active campaign to keep your content schedule current via `list_campaign_posts`.

### Manage Real-Time Alerts (Webhooks)
Set up webhooks using `create_webhook` so your agent gets instant notifications when a member joins or a post publishes.

### View User Details
Pull specific data points—like membership status or profile details—for one person using `get_member`.

### Audit Account Status
Quickly check your authenticated user's profile and current permissions with the `get_identity` tool.

## Use Cases

### Auditing membership gaps
A community manager needs to know if Campaign B is performing as well as Campaign A. They ask their agent: "List all campaigns, and for the last two, pull the member list.". The agent runs `list_campaigns` then executes `list_campaign_members` twice, giving them a direct comparison report instantly.

### Responding to new content
A creator just published a major post. Instead of manually checking the dashboard, they prompt: "List all posts for Campaign ID 123 and create a webhook for future publishes.". The agent uses `list_campaign_posts` and then sets up the necessary alert using `create_webhook`.

### Tracking high-value users
The ops engineer wants to analyze the top 10 most engaged members. They ask the agent to list campaign members, filter for specific details (using `get_member`), and compile a spreadsheet of key contact points without ever leaving their local environment.

### Securing external actions
A developer needs to ensure that any new integration only runs if the user has the right permissions. They run `get_identity` first, confirming the active token's scope before attempting complex webhook management or data retrieval.

## Benefits

- See who's subscribed and how many you have by calling `list_campaign_members`. You get an instant roster without navigating through member dashboards.
- Stay ahead of content gaps. Use `list_campaign_posts` to pull a full history of posts across all your campaigns, so you know exactly what needs promoting next.
- Automate communication flow. Setting up webhooks with `create_webhook` means when someone hits a milestone (like joining), an action happens automatically elsewhere.
- Know your audience deeply. Instead of just counting heads, use `get_member` to fetch specific details on key members for targeted outreach.
- Keep track of everything in one place. Running `list_campaigns` gives you the full scope of campaigns and their associated data points immediately.

## How It Works

The bottom line is you manage your entire creator ecosystem—from posts to members—without ever leaving your chat window or IDE.

1. Subscribe to the Patreon server on Vinkius Marketplace and provide your Creator Access Token.
2. Ask your AI agent a natural language question (e.g., "What's my engagement rate for Campaign X?").
3. The agent translates the request into tool calls (`list_campaign_members`, `get_member`) and returns a summary of the data.

## Frequently Asked Questions

**How do I list all my campaigns using list_campaigns?**
You simply ask your agent to run `list_campaigns`. It returns an overview of every campaign tied to your account, giving you the IDs and names needed for subsequent actions.

**Can I get member details using get_member?**
Yes. If you have a specific member's ID, running `get_member` pulls their detailed profile information directly to your agent's output. This is better than relying on basic list views.

**What if I need to change an existing webhook?**
You use the `update_webhook` tool. You give it the ID of the webhook you want to change, and specify which parameters (like the target URL or event type) need updating.

**Is list_campaign_members better than just using get_member?**
If you need a bulk count or a roster of many people, use `list_campaign_members`. Use `get_member` only when you know the specific ID and want details on that one person.

**Using the `get_identity` tool, what scope of data can I check for my connected Patreon account?**
It returns your authenticated profile details and associated permissions. You'll see if your token includes memberships and campaign viewing rights, letting you verify access before running other tools.

**What is the workflow for checking and managing existing notifications using `list_webhooks`?**
You use `list_webhooks` to pull a manifest of all current webhook setups. This lets you confirm which events are monitored, helping you decide if you need to update or delete any feeds.

**How does the data from `get_campaign` differ from just listing campaigns with `list_campaigns`?**
`list_campaigns` only provides a high-level overview of your campaigns. Calling `get_campaign` pulls all the deep, specific metrics and details for one campaign ID you specify.

**When I use the `create_webhook` tool, what events trigger real-time notifications?**
You define which actions generate alerts. These include membership creation or when a post is published. The webhook ensures your agent gets live updates from Patreon when those specific events occur.

**Can I list all members of a specific campaign?**
Yes, you can use the `list_campaign_members` tool by providing the specific Campaign ID to retrieve a full list of associated members.

**Is it possible to set up real-time notifications for new members?**
Absolutely. Use the `create_webhook` tool with the `members:create` trigger and your destination URI to start receiving real-time updates.

**Can I see the posts I have published on my campaign?**
Yes, the `list_campaign_posts` tool allows you to fetch all posts associated with a specific campaign ID.