# Patreon Tiers & Members AI Agent Connect

> Patreon tier and member detail APIs as an MCP: campaign tiers with amounts/benefits, member shipping addresses and tier history, user profiles, funding goals — official API v2 JSON:API (complementary to the Patreon creator subscriptions MCP).

## Overview
- **Category:** billing-subscriptions
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Wyy5GLUDmcMNlc0DZUCHT5zRp2H5MuP124Wmh1jr/ai-agent-connect
- **Tags:** patreon, membership-tiers, creator-economy, member-analytics, shipping-addresses, jsonapi

## Description

**Patreon tier and member detail APIs** (API v2, JSON:API) as a single MCP server — the deeper membership layer complementing the campaigns/members/posts companion.

### What you can do
- **Campaign tiers** — full tier objects: amount_cents, titles, descriptions, patron counts, linked benefits
- **Member addresses** — shipping addresses for physical rewards (creator scope)
- **Member tier history** — currently entitled tiers, pledge history and lifetime support per member
- **User profiles** — public profiles of ANY Patreon user by id (name, vanity, about, image)
- **Funding goals** — campaign milestone goals with completion percentages

### Authentication
Same OAuth2 access token as the Patreon creator subscriptions MCP — create an app at patreon.com/portal, get the creator's authorization code, and paste the Bearer token. JSON:API responses use `data`, `included`, `relationships` — fields must be explicitly requested with URL-encoded brackets (`fields%5Btier%5D=amount_cents,title`).

### Who is this for?
Creator analytics, reward fulfilment, patron CRM tools and AI agents that need the deep membership layer of Patreon campaigns.

## Tools

### get_member_address
Get a member's shipping address (for physical rewards fulfilment)

### get_user_by_vanity
g. patreon.com/anker) to a user id — search-free: GET /user/{id} after discovery via campaign includes. Note: Patreon v2 has no vanity search; use get_campaign_tiers include=creator to find creator user ids.

Find a Patreon user id by their vanity URL slug (www.patreon.com/{vanity})

### get_campaign_tiers
campaign_id from the companion patreon-creator-subscriptions-mcp list_campaigns.

Get all membership tiers of a campaign with amounts, titles and benefits

### get_user_profile
Different from get_identity (the token owner): this works for ANY user id.

Get any Patreon user profile by id (public fields: name, vanity, image, about)

### get_campaign_goals
Goals are a strong engagement signal for content planning.

Get the funding goals of a campaign (target amounts and progress)

### get_member_tiers_history
Get the entitled tiers and payment history context of a member

## Prompt Examples

**Prompt:** 
```
Show me all membership tiers of my campaign with their benefits
```

**Response:** 
```
🎯 **Campaign tiers (JSON:API included=tiers)**

1. **Starter** — $3/month: early access to videos, patron-only feed
2. **Supporter** — $10/month: + exclusive blog, Discord role
3. **Insider** — $25/month: + monthly Q&A, name in credits

Patron counts and benefit lists included. Want the shipping addresses of Insider members?
```

**Prompt:** 
```
Get the shipping address of member 123-456-789 for the reward shipment
```

**Response:** 
```
📦 **Member shipping address (creator scope)**

Member: 123-456-789, patron status: active_patron
Entitled amount: $25/mo

Address:
- Addressee: John Doe
- Line 1: 123 Main St
- City: Austin, TX 78701, US

Creator scope required — addresses are only exposed to the campaign owner.
```

**Prompt:** 
```
How close is my campaign to its funding goals?
```

**Response:** 
```
🎯 **Campaign goals progress**

1. First milestone — $1,000/mo: ✅ 145% completed
2. Studio upgrade — $3,000/mo: 🔶 48% completed

Goals are pulled from included=goals with completion percentages. Want the tier breakdown driving the progress?
```

## Frequently Asked Questions

**Do I need the same access token as the Patreon creator subscriptions MCP?**
Yes — same OAuth2 Bearer token, same scopes. The difference is the endpoint layer: that MCP covers campaigns/members/posts/identity/webhooks CRUD; this one covers the deeper tier, address, user profile and goals layer with no tool overlap.

**Why are fields URL-encoded with brackets?**
Patreon API v2 uses the JSON:API specification: fields[member]=full_name is the standard sparse fieldset syntax, and brackets must be URL-encoded (fields%5Bmember%5D=full_name). The MCP handles the encoding automatically.