Patreon MCP tools

MCP tool patreon_list_tiers

Returns every tier on your Patreon page. Use the tier_id of each item in the other endpoints. Benefits are the ones shown in the tier editor.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_list_tiers",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "tiers": [
      {
        "tier_id": "24019876",
        "name": "Gold",
        "description": "Everything in Supporter plus early episodes.",
        "benefits": [
          "Episodes a week before release",
          "Monthly Q&A"
        ]
      }
    ]
  },
  "isError": false
}

MCP tool patreon_list_members

Lists members the way the Relationship manager does. Filter by paid or free, active or canceled, tier or join date. Pass next_cursor back as cursor for the next page.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_list_members",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "members": [
      {
        "member_id": "m_4471920",
        "name": "Maya Fischer",
        "tier": "Gold",
        "status": "active",
        "paid": true,
        "joined_at": "2026-10-08T10:12:00Z"
      }
    ],
    "next_cursor": "eyJvZmZzZXQiOjUwfQ"
  },
  "isError": false
}

MCP tool patreon_export_members

Runs the same CSV export as the button in the Relationship manager, with the filters you pass. The file has the columns you chose in the table settings, plus Charge frequency if you offer annual memberships. It reaches no one and changes nothing.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_export_members",
    "arguments": {
      "paid": "paid",
      "status": "active"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "file_url": "https://cotlet.dev/api/v1/files/exports/patreon-members-2026-10-11.csv",
    "rows": 214,
    "filters": {
      "status": "active",
      "tier_id": "24019876"
    }
  },
  "isError": false
}

MCP tool patreon_list_posts

Lists your posts. Scheduled posts come first, labeled with their date, as in the Patreon post list. Body is a short preview; get_post returns the full text.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_list_posts",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "posts": [
      {
        "post_id": "118204553",
        "title": "Episode 12: the full cut",
        "status": "scheduled",
        "publish_at": "2026-10-16T18:00:00+01:00",
        "audience": "paid_tiers",
        "preview": "This week we go behind the scenes..."
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

MCP tool patreon_get_post

Returns one post with its full body and the tiers that can see it. Use it before update_post to see what is there now.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_get_post",
    "arguments": {
      "post_id": "post_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "post_id": "118204553",
    "title": "Episode 12: the full cut",
    "body": "This week we go behind the scenes...",
    "status": "scheduled",
    "publish_at": "2026-10-16T18:00:00+01:00",
    "tier_ids": [
      "24019876"
    ],
    "url": "https://www.patreon.com/posts/episode-12-118204553"
  },
  "isError": false
}

MCP tool patreon_list_chats

Lists your Chats, most recent first, with the member, the last message and whether you sent it. Set unanswered_only to see what needs a reply.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_list_chats",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "chats": [
      {
        "member_id": "m_4471920",
        "name": "Maya Fischer",
        "last_message": "Where do I find the Q3 files?",
        "last_from": "member",
        "updated_at": "2026-10-10T16:02:00Z"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

MCP tool patreon_create_post

Creates a draft in your Patreon post list. Nobody sees it until publish_post or schedule_post. create_post runs without asking first: it reaches no one and a draft is removed with one call in Patreon.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_create_post",
    "arguments": {
      "title": "title",
      "body": "body"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "post_id": "118204553",
    "status": "draft",
    "audience": "paid_tiers",
    "tier_ids": [
      "24019876"
    ],
    "title": "Episode 12: the full cut"
  },
  "isError": false
}

MCP tool patreon_update_post

Edits a post that is not published yet, as you would in the post editor. It reaches no one until the post goes out, so it runs without asking first. Published posts are not changed.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_update_post",
    "arguments": {
      "post_id": "post_8c41d2",
      "fields": "fields"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "post_id": "118204553",
    "status": "draft",
    "title": "Episode 12: the director's cut"
  },
  "isError": false
}

MCP tool patreon_schedule_post

Schedules a draft, which then shows at the top of your post list labeled Scheduled. Set notify_members to false to switch off the member notification for this post. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_schedule_post",
    "arguments": {
      "post_id": "118204553",
      "publish_at": "2026-10-16T18:00:00+01:00",
      "notify_members": true
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "post_id": "118204553",
    "status": "scheduled",
    "publish_at": "2026-10-16T18:00:00+01:00",
    "audience": "paid_tiers",
    "tier_ids": [
      "24019876"
    ],
    "url": "https://www.patreon.com/posts/episode-12-118204553"
  },
  "isError": false
}

MCP tool patreon_publish_post

Publishes a draft immediately to its audience. Members are notified unless notify_members is false. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_publish_post",
    "arguments": {
      "post_id": "post_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "post_id": "118204553",
    "status": "published",
    "url": "https://www.patreon.com/posts/episode-12-118204553"
  },
  "isError": false
}

MCP tool patreon_send_message

Sends a direct message to one member in Chats. Patreon allows direct messages only to current or former paid members, so a free member returns an error. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_send_message",
    "arguments": {
      "member_id": "m_4471920",
      "body": "Hi Maya, the Q3 files are in the Q3 collection, third post from the top."
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "member_id": "m_4471920",
    "status": "sent",
    "sent_at": "2026-10-11T09:05:00+02:00"
  },
  "isError": false
}

MCP tool patreon_message_tier

Sends one message to the members of the tiers you name, as the Relationship manager does when you filter by tier. Only paid members can be messaged. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_message_tier",
    "arguments": {
      "tier_ids": [
        "24019876",
        "24019877"
      ],
      "body": "Your October pack is ready: https://example.com/october-pack. Thanks for being here!"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "tier_ids": [
      "24019876"
    ],
    "status": "sent",
    "recipients": 214
  },
  "isError": false
}

MCP tool patreon_update_tier

Edits the fields at the top of the tier editor: name, description and benefits. Members see the change on your page. Prices are not changed by this tool. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "patreon_update_tier",
    "arguments": {
      "tier_id": "tier_8c41d2",
      "fields": "fields"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "tier_id": "24019876",
    "name": "Gold",
    "benefits": [
      "Episodes a week before release",
      "Monthly Q&A",
      "Monthly Q&A call"
    ],
    "status": "updated"
  },
  "isError": false
}