patreon

Read Patreon campaigns, members, tiers, and identity (read-only). Trigger phrases: patreon, patrons, members, campaign earnings, membership tiers.

SKILL.md

GitHub

Patreon

Purpose

Read the user's Patreon membership business: identity, campaigns, members, and tiers. Patreon's API is effectively read-only for creators, so this connector reads only and carries zero write risk. Use when the user mentions Patreon, patrons, or membership earnings.

Tooling

All commands go through bin/patreon.py:

bin/patreon.py auth                                      # verify the access token
bin/patreon.py identity --include memberships,campaign   # show the current user
bin/patreon.py campaign --campaign-id 123456            # show a campaign
bin/patreon.py members --campaign-id 123456 --limit 25  # list campaign members
bin/patreon.py tiers --campaign-id 123456 --limit 25    # list membership tiers

Auth

  • Provider id: patreon (credential is collected as custom.patreon)
  • Collection: Creator's Access Token via the secure credential flow (credentials.request_api_access); issued self-serve from the Patreon client portal, no app review needed for your own data
  • Allowed hosts: www.patreon.com
  • Status check: bin/patreon.py auth (must return "ok": true)

Operating Rules

  1. This connector is read-only by construction: Patreon exposes no creator write endpoints, so there is nothing to confirmation-gate. Never invent a write the API does not have.
  2. Platform fees are tiered by plan (roughly 5-12%) plus payment processing, and the API surfaces campaign totals rather than a live ledger.
  3. Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/patreon.py). Do not print, log, or transmit the token value.

Files

  • SKILL.md
  • bin/patreon.py

Maturity

🧪 Draft: written from Patreon's public API docs; not yet live-tested end-to-end.