{
  "markdown": "# Patreon MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io)\n[![PyPI](https://img.shields.io/pypi/v/patreon-mcp-server)](https://pypi.org/project/patreon-mcp-server/)\n\nmcp-name: io.github.KyuRish/patreon-mcp-server\n\nGive AI assistants access to your Patreon creator data. The first authenticated Patreon MCP server  - works with Claude Desktop, Cursor, Windsurf, VS Code Copilot, and any MCP-compatible client.\n\n## Quick Start\n\n### 1. Get your Creator Access Token\n\nGo to [Patreon Developer Portal](https://www.patreon.com/portal/registration/register-clients) and copy your **Creator Access Token**. This token gives access to your own campaign data only.\n\n### 2. Configure your MCP client\n\n**Claude Desktop**  - add to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"patreon\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--directory\", \"/path/to/patreon-mcp-server\", \"src/patreon_mcp_server/server.py\"],\n      \"env\": {\n        \"PATREON_ACCESS_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code**  - add to `.mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"patreon\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--directory\", \"/path/to/patreon-mcp-server\", \"src/patreon_mcp_server/server.py\"],\n      \"env\": {\n        \"PATREON_ACCESS_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n### 3. Start using it\n\nAsk your AI assistant things like:\n- \"Show me my Patreon campaigns\"\n- \"Who are my top patrons by lifetime support?\"\n- \"How many patrons are on each tier?\"\n- \"Which patrons have declining payments?\"\n- \"List my recent posts\"\n\n## Available Tools\n\n| Tool | Description | Returns |\n|------|-------------|---------|\n| `fetch_identity` | Your authenticated profile | `User` |\n| `fetch_campaigns` | List all your campaigns | `Campaign[]` |\n| `fetch_campaign` | Campaign details with tier breakdown | `CampaignDetail` |\n| `fetch_members` | Paginated patron list (100/page) | `MemberPage` |\n| `fetch_posts` | Paginated post list (20/page) | `PostPage` |\n| `fetch_post` | Single post by ID | `Post` |\n\n**Pagination**: `fetch_members` and `fetch_posts` return a `next_cursor` field. Pass it as the `cursor` parameter to fetch the next page.\n\n## Data Fields\n\n### Member\n`full_name`, `patron_status`, `pledge_cadence`, `lifetime_support_cents`, `currently_entitled_amount_cents`, `last_charge_date`, `last_charge_status`, `will_pay_amount_cents`, `is_follower`, `tiers`, `user_name`\n\n### Campaign\n`creation_name`, `patron_count`, `pledge_url`, `published_at`, `url`, `vanity`, `is_monthly`, `created_at`, `image_url`, `summary`, `one_liner`, `pay_per_name`\n\n### Tier\n`title`, `amount_cents`, `description`, `published`, `patron_count`\n\n### Post\n`title`, `content`, `is_paid`, `is_public`, `published_at`, `url`, `embed_data`, `embed_url`\n\n## Privacy & Data\n\nThis server is designed with patron privacy in mind:\n\n- **No patron emails**  - email addresses are never requested from the API\n- **No private notes**  - creator notes about patrons are excluded\n- **Read-only**  - no write operations, the server only reads your data\n- **No data storage**  - the MCP server itself does not cache or persist any data\n\n**Important**: When using this server with an AI assistant, patron data (names, pledge amounts, charge status) is sent to your AI provider (e.g., Anthropic, OpenAI) and may be temporarily retained per their data processing policies. You are responsible for ensuring your use complies with [Patreon's Creator Privacy Promise](https://support.patreon.com/hc/en-us/articles/360026912432) and applicable data protection laws.\n\nThis project is not affiliated with or endorsed by Patreon.\n\n## Prerequisites\n\n- Python 3.11+\n- [uv](https://docs.astral.sh/uv/) package manager\n\n```bash\n# Clone the repo\ngit clone https://github.com/kyurish/patreon-mcp-server.git\ncd patreon-mcp-server\n\n# Install dependencies\nuv sync\n\n# Test it runs\nPATREON_ACCESS_TOKEN=your_token uv run src/patreon_mcp_server/server.py\n```\n\n## Project Structure\n\n```\nsrc/patreon_mcp_server/\n  server.py        # Entry point\n  mcp_server.py    # FastMCP init + client instance\n  tools.py         # @mcp.tool() definitions\n  models.py        # Pydantic models + JSON:API parsers\n  utils/\n    client.py      # PatreonClient (HTTP layer)\n```\n\n## Roadmap\n\nThis server is currently read-only. Write operations (create posts, manage tiers, send messages to patrons) will be added if there's enough demand - [open an issue](https://github.com/kyurish/patreon-mcp-server/issues) or star the repo to show interest.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Support\n\nIf you find this useful, consider supporting development on [Patreon](https://www.patreon.com/kyurish).\n",
  "bytes": 4945,
  "sha": "683fd37b7ec869862fe40abac4f065db4b8796a5ca4bb8883fd5ceac8ad7545a",
  "repo_slug": "kyurish/patreon-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kyurish_patreon_mcp_server_fa20deac/readme"
}