# Bandruption Platform Docs > Public documentation for Bandruption artists, fans, music industry teams, events, ticketing, loyalty, merchandise, subscriptions, and Top Songs. ## Site - Origin: https://docs.bandruption.fun - Sitemap: https://docs.bandruption.fun/sitemap.xml - Full Markdown corpus: https://docs.bandruption.fun/llms-full.txt - Homepage Markdown alternate: https://docs.bandruption.fun/markdown/index.md ## Markdown Documentation - [Welcome to Bandruption](https://docs.bandruption.fun/markdown/docs/intro.md) - [Artists Overview](https://docs.bandruption.fun/markdown/docs/artists/overview.md) - [Events Overview](https://docs.bandruption.fun/markdown/docs/events/overview.md) - [Fans Overview](https://docs.bandruption.fun/markdown/docs/fans/overview.md) - [Top Songs β€” Public Scoring Methodology (v1.0)](https://docs.bandruption.fun/markdown/docs/fans/top-songs.md) - [Music Industry Overview](https://docs.bandruption.fun/markdown/docs/music-industry/overview.md) - [Ticketing Overview](https://docs.bandruption.fun/markdown/docs/ticketing/overview.md) - [Bounties](https://docs.bandruption.fun/markdown/docs/artists/bounties.md) - [Loyalty Programs](https://docs.bandruption.fun/markdown/docs/artists/loyalty-programs.md) - [Merchandise](https://docs.bandruption.fun/markdown/docs/artists/merchandise.md) - [Subscriptions](https://docs.bandruption.fun/markdown/docs/artists/subscriptions.md) - [Bandruption MCP Connector](https://docs.bandruption.fun/markdown/docs/developers/mcp.md) - [Methodology Versions](https://docs.bandruption.fun/markdown/docs/fans/methodology-versions.md) - [Proof of Music Fandom](https://docs.bandruption.fun/markdown/docs/fans/proof-of-music-fandom.md) - [Industry Subscriptions](https://docs.bandruption.fun/markdown/docs/music-industry/subscriptions.md) - [Purchasing Tickets](https://docs.bandruption.fun/markdown/docs/ticketing/purchasing-tickets.md) ## Agent Access Policy - Public docs pages are indexable and deterministic. - Search and real-time AI input are allowed. - AI model training is not allowed by the published Content-Signal policy. - Same-URL `Accept: text/markdown` negotiation is not claimed for this static Docusaurus/GitHub Pages deployment. ## Not Applicable On This Domain - API catalog: docs.bandruption.fun is public documentation, not a public API host. - MCP Server Card: docs.bandruption.fun does not expose MCP tools. - Agent Skills index: docs.bandruption.fun does not expose agent-callable skills. - OAuth/OIDC and RFC 9728 metadata: docs.bandruption.fun has no OAuth-protected resource boundary. - WebMCP and commerce discovery: no approved docs-domain protocol surface exists today. --- # Full Markdown Corpus ## Homepage # Bandruption Platform Docs Bandruption documentation for artists, fans, music industry teams, events, ticketing, loyalty, merchandise, subscriptions, and the fan-driven Top Songs chart. ## Agent-readable entry points - Canonical HTML site: https://docs.bandruption.fun/ - Sitemap: https://docs.bandruption.fun/sitemap.xml - Agent summary: https://docs.bandruption.fun/llms.txt - Full Markdown corpus: https://docs.bandruption.fun/llms-full.txt ## Markdown alternates - [Welcome to Bandruption](https://docs.bandruption.fun/markdown/docs/intro.md) - HTML: https://docs.bandruption.fun/docs/intro - [Artists Overview](https://docs.bandruption.fun/markdown/docs/artists/overview.md) - HTML: https://docs.bandruption.fun/docs/artists/overview - [Events Overview](https://docs.bandruption.fun/markdown/docs/events/overview.md) - HTML: https://docs.bandruption.fun/docs/events/overview - [Fans Overview](https://docs.bandruption.fun/markdown/docs/fans/overview.md) - HTML: https://docs.bandruption.fun/docs/fans/overview - [Top Songs β€” Public Scoring Methodology (v1.0)](https://docs.bandruption.fun/markdown/docs/fans/top-songs.md) - HTML: https://docs.bandruption.fun/docs/fans/top-songs - [Music Industry Overview](https://docs.bandruption.fun/markdown/docs/music-industry/overview.md) - HTML: https://docs.bandruption.fun/docs/music-industry/overview - [Ticketing Overview](https://docs.bandruption.fun/markdown/docs/ticketing/overview.md) - HTML: https://docs.bandruption.fun/docs/ticketing/overview - [Bounties](https://docs.bandruption.fun/markdown/docs/artists/bounties.md) - HTML: https://docs.bandruption.fun/docs/artists/bounties - [Loyalty Programs](https://docs.bandruption.fun/markdown/docs/artists/loyalty-programs.md) - HTML: https://docs.bandruption.fun/docs/artists/loyalty-programs - [Merchandise](https://docs.bandruption.fun/markdown/docs/artists/merchandise.md) - HTML: https://docs.bandruption.fun/docs/artists/merchandise - [Subscriptions](https://docs.bandruption.fun/markdown/docs/artists/subscriptions.md) - HTML: https://docs.bandruption.fun/docs/artists/subscriptions - [Bandruption MCP Connector](https://docs.bandruption.fun/markdown/docs/developers/mcp.md) - HTML: https://docs.bandruption.fun/docs/developers/mcp - [Methodology Versions](https://docs.bandruption.fun/markdown/docs/fans/methodology-versions.md) - HTML: https://docs.bandruption.fun/docs/fans/methodology-versions - [Proof of Music Fandom](https://docs.bandruption.fun/markdown/docs/fans/proof-of-music-fandom.md) - HTML: https://docs.bandruption.fun/docs/fans/proof-of-music-fandom - [Industry Subscriptions](https://docs.bandruption.fun/markdown/docs/music-industry/subscriptions.md) - HTML: https://docs.bandruption.fun/docs/music-industry/subscriptions - [Purchasing Tickets](https://docs.bandruption.fun/markdown/docs/ticketing/purchasing-tickets.md) - HTML: https://docs.bandruption.fun/docs/ticketing/purchasing-tickets --- ## Welcome to Bandruption Source HTML: https://docs.bandruption.fun/docs/intro Markdown alternate: https://docs.bandruption.fun/markdown/docs/intro.md # Welcome to Bandruption **Bandruption** is a music platform built for artists, music industry professionals, and fans. It brings together fan loyalty programs, subscriptions, merchandise, events, ticketing, and a fan-driven music chart in one place. ## What Can You Do on Bandruption? ### 🎀 [Artists](./artists/overview.md) Build your fanbase, monetize your music, and reward your most loyal supporters. - Create and customize your artist profile - Sell merchandise and digital products - Set up fan subscription tiers with members-only content - Run loyalty programs with points, tiers, bounties, and redemptions - Host events and manage ticket sales ### 🏒 [Music Industry](./music-industry/overview.md) Industry professionals and companies can establish a presence, host events, and offer exclusive member subscriptions. - Create a music industry profile - Offer exclusive subscription tiers to members - Host industry events and manage ticketing ### πŸ“… [Events](./events/overview.md) Create and manage live or virtual events for your audience. - Publish event details with location and virtual link support - Set event capacity and manage attendee lists - Gate access to members-only events by subscription tier - Track ticket sales in real time ### 🎟️ [Ticketing](./ticketing/overview.md) Flexible, per-event ticket types with built-in access control. - Create multiple ticket types per event (e.g. General, VIP, RSVP) - Set prices, sales windows, and per-user quantity limits - Offer member-discounted pricing for subscribers - One-click RSVP for free events - Collectible ticket variants combining artist-provided artwork and AI-generated design ### 🎧 [Fans](./fans/overview.md) Every fan gets a public profile and a curated Top 10 that feeds the global charts. - Curate your personal Top 10 playlist - Follow artists and industry profiles - Earn loyalty points, tier up, and unlock rewards - Collect digital tickets and proof-of-attendance for events you've been to ### πŸ“Š [Top Songs](./fans/top-songs.md) The People's Top 10 β€” a global music chart aggregated from real fan playlists. - Charts updated weekly, monthly, and all-time - Filter by genre and region - Every fan's Top 10 contributes to the rankings --- ## Platform Index | Section | Topics | |---------|--------| | [Artists](./artists/overview.md) | Profile, Subscriptions, Loyalty Programs, Merchandise | | [Music Industry](./music-industry/overview.md) | Profile, Subscriptions, Events | | [Events](./events/overview.md) | Creating Events, Access Control, Virtual Events | | [Ticketing](./ticketing/overview.md) | Ticket Types, Pricing, RSVP, Collectible Ticket Designs | | [Fans](./fans/overview.md) | Fan Profile, Top 10, Collection, Following | | [Top Songs](./fans/top-songs.md) | People's Top 10 charts | --- ## Explore the API The Bandruption platform exposes a comprehensive REST API. Visit the interactive [API Reference](https://bandruption.fun/api-docs) to explore all available endpoints, request/response schemas, and try requests directly. --- ## Need Help? - Visit [bandruption.fun](https://bandruption.fun) to use the platform - Join the community on [Discord](https://discord.gg/bandruption) - Follow updates on [X / Twitter](https://x.com/bandruption) --- ## Artists Overview Source HTML: https://docs.bandruption.fun/docs/artists/overview Markdown alternate: https://docs.bandruption.fun/markdown/docs/artists/overview.md # Artists Overview Bandruption gives musicians and bands everything they need to build a sustainable, direct relationship with their fans. From profile setup to paid events, all tools are available from your artist dashboard at [bandruption.fun](https://bandruption.fun). ## Feature Summary | Feature | Description | |---------|-------------| | [Profile Management](#profile-management) | Public-facing artist page with bio, links, and media | | [Subscriptions](./subscriptions.md) | Recurring fan club tiers with exclusive content | | [Bounties](./bounties.md) | Fan action campaigns with claim review and rewards | | [Loyalty Programs](./loyalty-programs.md) | Points, tiers, and reward redemptions | | [Merchandise](./merchandise.md) | Physical and digital product store | | Events | Host live and virtual events (see [Events](../events/overview.md)) | | Ticketing | Sell tickets to your events (see [Ticketing](../ticketing/overview.md)) | --- ## Profile Management Your artist profile is your public home on Bandruption. It displays your bio, music, social links, subscription tiers, and merchandise. Once approved, it lives at `bandruption.fun/` and is split into tabs: **Loyalty Program**, **Members Content**, and **Store**. ### What you can configure - **Display name and bio** β€” Write a short description that appears on your public profile page - **Avatar and banner images** β€” Upload a profile photo and a wide banner image - **Genre tags** β€” Select genres so fans can discover your music - **Social media links** β€” Connect Instagram, Twitter/X, Spotify, TikTok, and Discord - **Verification status** β€” Verified artists get a badge on their profile ### Getting your profile approved New artist profiles go through a brief approval process: 1. Sign in to [bandruption.fun](https://bandruption.fun) 2. Open your **Dashboard** and go to the **Profile** tab 3. Submit an artist application with your profile details 4. The Bandruption team reviews and approves your application Once approved, your profile is publicly visible and you can start using all artist features. --- ## Next Steps - [Set up fan subscriptions](./subscriptions.md) - [Create a loyalty program](./loyalty-programs.md) - [Add merchandise to your store](./merchandise.md) - [Create an event](../events/overview.md) --- ## Events Overview Source HTML: https://docs.bandruption.fun/docs/events/overview Markdown alternate: https://docs.bandruption.fun/markdown/docs/events/overview.md # Events Overview Both artists and music industry profiles can host live and virtual events on Bandruption. Events can be free or paid, in-person or online, and can be restricted to subscribers-only or open to all. ## Feature Summary | Feature | Description | |---------|-------------| | Creating an Event | Publish a new event with details and settings | | Virtual Events | Online events with a streaming or meeting link | | Access Control | Restrict event access to specific subscriber tiers | | Capacity Management | Set max attendee limits | | [Ticketing](../ticketing/overview.md) | Configure ticket types, pricing, and sales windows | --- ## Creating an Event From your admin dashboard, go to **Events β†’ Create Event**. ### Event Fields | Field | Description | |-------|-------------| | **Title** | Event name displayed to fans | | **Description** | Full event description (supports rich text) | | **Date and Time** | When the event takes place | | **Timezone** | Timezone for the event date/time | | **Location** | Venue name and address for in-person events | | **Event images** | Upload one or more promotional images | | **Published** | Toggle public visibility | | **Cancelled** | Mark an event as cancelled | --- ## Virtual Events To create a virtual (online) event: 1. Enable the **Virtual** toggle when creating or editing the event 2. Enter the **Virtual Link** β€” this can be a YouTube Live URL, Zoom meeting link, Twitch stream, or any streaming platform URL 3. The link is displayed to attendees who hold a valid ticket or RSVP --- ## Subscription Access Control You can restrict event attendance to fans who hold an active subscription tier: - Select one or more **required subscription tiers** when creating the event - Fans without an active subscription to one of those tiers will see the event but will be prompted to subscribe before they can purchase a ticket - This works for both artist subscription tiers and music industry subscription tiers --- ## Capacity Management Set a **maximum attendee count** to cap total attendance across all ticket types. Once the cap is reached, the event is shown as "At Capacity" and no further tickets can be purchased. --- ## Managing Events From your events dashboard you can: - View all upcoming and past events - Edit event details and images - Monitor ticket sales and attendee counts in real time - Cancel events (attendees are notified) - View per-ticket-type sales breakdowns --- ## Next Steps - [Configure ticket types for your event](../ticketing/overview.md) --- ## Fans Overview Source HTML: https://docs.bandruption.fun/docs/fans/overview Markdown alternate: https://docs.bandruption.fun/markdown/docs/fans/overview.md # Fans Overview Anyone with a Bandruption account is a fan, and every fan gets a public profile, a curated music chart, and tools for following the artists and industry profiles they care about. Visit `bandruption.fun/fan/` to see your own profile, or browse other fans the same way. ## What's on a Fan Profile A fan profile is organized into tabs. Most are visible to anyone, but a fan can hide individual tabs from public view if they want. | Tab | What it shows | |-----|---------------| | **Top 10** | The fan's curated personal Top 10 playlist. These tracks feed the global [People's Top 10](./top-songs.md) charts. | | **Collection** | Fan rewards the fan has earned, including proof-of-attendance items from events they've been to. | | **Events** | Events the fan is attending or has attended. | | **Following** | Artists and music industry profiles the fan follows. | | **Tickets** | Tickets the fan currently holds. | | **Store** | Items the fan has purchased from artist stores. | | **Affiliates** | Affiliate links the fan can share to earn rewards (when participating). | ## Following Artists and Industry Profiles From any artist or industry profile page, click **Follow** to add them to your Following tab. Following helps surface their new content in your feed and signals support β€” it does not by itself grant subscriber-only access. To unlock members-only content, gated events, or member ticket pricing, use the artist's [subscription tiers](../artists/subscriptions.md) instead. ## Earning Loyalty Points When you spend on an artist's store, subscribe, buy a ticket, or complete a [bounty](../artists/bounties.md), you earn loyalty points with that artist's program. Each artist runs their own program with their own rewards β€” see [Loyalty Programs](../artists/loyalty-programs.md) for how the points and tiers work. ## Buying Tickets and Subscribing Buying a ticket or starting a subscription happens directly from the artist or industry profile. See [Purchasing Tickets](../ticketing/purchasing-tickets.md) for how the ticket flow works. ## Next Steps - [Curate your Top 10 and explore the People's Top 10 charts](./top-songs.md) - [Find events to attend](https://bandruption.fun/events) - [Browse active bounties](https://bandruption.fun/bounties) --- ## Top Songs β€” Public Scoring Methodology (v1.0) Source HTML: https://docs.bandruption.fun/docs/fans/top-songs Markdown alternate: https://docs.bandruption.fun/markdown/docs/fans/top-songs.md # Top Songs β€” Public Scoring Methodology (v1.0) **People's Top Songs** is a transparent, fan-powered ranking system for music: how ranked Top 10 lists, verified activity, playlist support, and revocable fan connections become a public chart. **Version 1.0 β€” July 2026** > "Every fan has a voice. Verified effort and community trust make some voices travel farther." See the live chart at [bandruption.fun/en/top-songs](https://bandruption.fun/en/top-songs). ## Quick Reference ### The core rule ```text Song vote = Rank points Γ— Vote multiplier Free fan multiplier: 1 Superfan multiplier: 1 + √Fan Score + Verified Follows + Playlist Proof ``` ### How your Top 10 changes the chart Every eligible fan keeps one ranked Top 10. The song in first place begins with 10 rank points; the song in tenth begins with 1. A free fan uses a multiplier of 1. An active Superfan or higher activates additional influence earned from verified activity, verified Bandruption followers, and song-specific playlist proof. A subscription by itself does not add chart points. With no Fan Score, no verified followers, and no playlist proof, a new Superfan has the same multiplier as a free fan: 1. All calculations use full precision. Public displays may round to two decimal places. #### Rank points | Position | Points | Position | Points | |----------|--------|----------|--------| | 1 | 10 | 6 | 5 | | 2 | 9 | 7 | 4 | | 3 | 8 | 8 | 3 | | 4 | 7 | 9 | 2 | | 5 | 6 | 10 | 1 | **The simplest way to matter.** Make a Top 10. Every eligible fan contributes directly. Put a song higher and it receives more rank points from your list. ### Worked scenarios All follows and playlist placements below are fully verified and fully vested; integrity eligibility E = 1. | Scenario | Rank | FS β†’ √FS | Follows F | Playlist P | Multiplier | Song vote | |----------|------|----------|-----------|------------|------------|-----------| | Free fan | 1 | 0 | 0 | 0 | 1 | 10 | | Free fan | 5 | 0 | 0 | 0 | 1 | 6 | | New Superfan | 1 | 0 | 0 | 0 | 1 | 10 | | Active Superfan | 1 | 25 β†’ 5 | 0 | 0 | 6 | 60 | | Community builder | 1 | 25 β†’ 5 | 20 | 0 | 26 | 260 | | Established Superfan | 1 | 100 β†’ 10 | 100 | 2 | 113 | 1,130 | | Same Superfan | 5 | 100 β†’ 10 | 100 | 2 | 113 | 678 | | Same Superfan | 10 | 100 β†’ 10 | 100 | 2 | 113 | 113 | ### Large-community behavior The formula remains linear in verified followers. The examples below hold rank at #1, Fan Score at 100 (10 activity units), and playlist proof at 2 services. | Full verified followers | Multiplier | Song vote at #1 | Change from one more follower | |-------------------------|------------|-----------------|-------------------------------| | 1,000 | 1,013 | 10,130 | +10 points | | 10,000 | 10,013 | 100,130 | +10 points | | 100,000 | 100,013 | 1,000,130 | +10 points | | 1,000,000 | 1,000,013 | 10,000,130 | +10 points | **What one additional verified follower does.** For a Superfan, every fully vested verified follower adds exactly one unit to F. That raises each song on the Superfan's list by its rank points: +10 for the #1 song, +9 for #2, down to +1 for #10. The follower does not inherit or multiply the Superfan's Fan Score or playlist proof. **No fixed follower ceiling.** F grows linearly and has no product-set cap or asymptote. Ten verified followers add ten units; 10,000 add 10,000. At any moment, the practical maximum is the number of other qualified Bandruption accounts, because each account can follow a given Superfan only once. That maximum grows with the community. ### Half-vested examples | Evidence | Vesting rule | Current unit | Effect on a #1 song | |----------|--------------|--------------|---------------------| | New verified follow, 15 days old | 15 Γ· 30 | 0.50 | +5 points | | Verified follow, 30+ days old | 30 Γ· 30 | 1.00 | +10 points | | Song in owned playlist for 3.5 days | 3.5 Γ· 7 | 0.50 | +5 points | | Song in owned playlist for 7+ days | 7 Γ· 7 | 1.00 | +10 points | ### Community amplification Following is a revocable network endorsement, not a one-person delegation budget. A direct vote and a network follow are separate actions. The system intentionally lets one real fan strengthen multiple real fan communities. A fan may follow any number of Superfans. The fan's support is not divided among them. If the fan follows ten Superfans, each of those ten Superfans can receive one verified follower unit after qualification and vesting. A follow amplifies the Superfan's entire Top 10, not only the song the two fans have in common. This creates accountability: a fan can inspect the public list, keep following while it represents their taste, and unfollow when it no longer does. An unfollow removes its follower unit at the next score calculation. In the example above, the fan's own #1 placement adds 10 points and ten fully vested follows add another 100 points across ten Superfan ballots. This is intentional: the chart measures organized, verified fandom as well as direct ranked preference. ### How to increase your impact Every path is visible, earned, revocable, or independently verifiable. | Action | What changes | Grounded chart effect | |--------|--------------|-----------------------| | Rank a song higher | Rank points | Moving #5 to #1 changes the base from 6 to 10. | | Activate Superfan or higher | S switches from 0 to 1 | Activates earned and community inputs; subscription alone adds no points. | | Raise Fan Score | √FS activity units | Fan Score 25 gives 5 units; 100 gives 10; 400 gives 20. | | Earn a verified follower | F starts increasing, reaching 1 after 30 days | Each full unit adds the song's rank points to every song on your list. | | Follow a Superfan | Their F increases after you qualify and the follow vests | You can follow any number of Superfans; your support is not divided. | | Keep the song in a supported, user-controlled playlist | P increases after 7-day vesting | One full service unit adds the song's rank points to that song. | ### What never buys chart power - Buying, holding, or spending BANDS. - Paying for a tier above Superfan; higher tiers do not receive an extra chart multiplier. - Raw follower counts from X, Instagram, Facebook, TikTok, or another external platform. - Adding the same song to several playlists on the same streaming service. - Direct payments to Bandruption or artists for guaranteed chart placement, fabricated votes, or synthetic follower amplification. - Unverified accounts, automated follows, concealed multi-account control, or purchased followers. ### The public promise No product purchase can buy a guaranteed chart position. Money can support the platform or fund legitimate fan work, but chart influence must come from a ranked choice, verified activity, verified community support, or verified playlist evidence. ## Abstract People's Top Songs is a transparent music ranking generated from fans' ranked Top 10 songlists. Every eligible fan begins with the same direct ballot: first place contributes 10 points, second contributes 9, and tenth contributes 1. An active Superfan or higher can activate additional influence earned through a visible Fan Score, verified Bandruption followers, and song-specific playlist proof. Free fans remain full participants and can also strengthen Superfans by following any number of public Top 10 lists they support. The model is neither a passive stream counter nor strict one-person-one-vote governance. It is a public measure of deliberate preference, verified music-support activity, and organized fan community. Its central social mechanism is revocable network endorsement: a qualifying follow adds one unit to the followed Superfan, vests over time, amplifies that Superfan's entire Top 10, and disappears when withdrawn. There is no hard follower ceiling. The methodology separates platform payment from guaranteed chart placement. Superfan status operates as an on/off switch for earned influence, not as a purchased block of votes. Buying, holding, or spending BANDS β€” Bandruption's closed-loop platform currency β€” never enters the score formula directly. Artists may compensate genuine fans through BANDS bounties and affiliate programs for verified Bandruption participation, including featuring songs in a Top 10 or satisfying disclosed rank or holding-duration conditions; those ballots are scored under the same rules and revocable community accountability as any other eligible ballot. This paper specifies the calculation, Fan Score registry, follower and playlist vesting, chart windows, integrity controls, privacy approach, technical feasibility of connected-platform verification, and public change process for Version 1.0. ## 1. Purpose and Scope ### 1.1 What the chart is designed to measure Most music metrics answer a useful but narrower question: how often was something played, viewed, purchased, or followed? People's Top Songs asks a different question: which songs are fans willing to place in a scarce Top 10, and how much verified community activity stands behind those choices? The distinction matters because passive counters can be manipulated. In a 2024 criminal case, the U.S. Department of Justice alleged that automated accounts generated billions of streams across hundreds of thousands of AI-generated songs and more than $10 million in royalties. The case is an extreme example, but it illustrates why a public fan-engagement chart should not rely on raw consumption alone. [\[2\]](#references) Bandruption therefore combines four observable signals: ranked choice, verified support activity, revocable in-platform following, and user-authorized playlist evidence. The live chart is published on Bandruption's People's Top Songs page. [\[1\]](#references) ### 1.2 What the chart is not - It is not a royalty statement, streaming chart, sales chart, or replacement for those measures. - It is not a claim that all voters have equal influence. Every fan has an equal baseline ballot, while additional influence is openly earned or entrusted. - It is not strict liquid democracy. Follows are not conserved delegations: one fan may follow and strengthen many Superfans. - It is not a marketplace for chart positions. No purchase produces a guaranteed score or placement. - It is not based on tokens or external ledger records. The system uses ordinary platform accounts, auditable databases, and BANDS as a closed-loop platform currency outside the chart formula. ### 1.3 Why a Top 10 A Top 10 makes attention scarce. A fan cannot include every song they mildly enjoy; they must choose ten and order them. The 10-to-1 rank schedule preserves a simple interpretation: a higher placement is a stronger expression of preference, but every listed song receives a positive contribution. ## 2. Design Principles **Universal baseline.** Every eligible account can publish one Top 10. Free participation is not symbolic; it contributes the complete 10-to-1 ballot. **Transparent amplification.** Every positive input appears in a public formula and in the voter's personal score breakdown. **Earned activity.** Concert attendance, qualified referrals, sustained playlist curation, completed bounties, affiliate results, and connected accounts can build Fan Score. **Revocable community trust.** Fans may follow any number of Superfans. Each qualified follow can strengthen the entire public Top 10 and can be withdrawn. **No hard follower ceiling.** Legitimate communities always retain room to grow. Anti-abuse controls verify the units rather than declaring that genuine supporters stop counting. **Additive, legible signals.** Fan activity, following, and playlist proof add separate units. They do not multiply one another into opaque cross-effects. **Payment separation.** A subscription activates earned inputs; BANDS and other purchases do not enter the score. **Integrity without punishing ordinary newcomers.** The direct ballot remains intact for eligible new fans. New high-impact signals vest over time, and suspicious activity is withheld for review rather than quietly half-weighted. **Privacy by design.** Connected services are accessed only with user authorization and the minimum practical scopes. External social graphs are not treated as portable voting rolls. ### 2.1 Representative inspiration, without pretending to be an election Liquid-democracy research studies systems in which voters may vote directly or delegate voting weight to others. That literature is useful because it highlights both the value of revocable representation and the danger of concentrated influence. [\[3\]](#references) [\[4\]](#references) People's Top Songs borrows the ideas of visible representatives, revocability, and public accountability, but uses a different rule: a fan's direct Top 10 remains theirs, while each follow is an additional network endorsement. Because one fan can endorse many Superfans, the system should be described as open community amplification rather than strict vote delegation. ## 3. Formal Scoring Specification **Authoritative Version 1.0 equation:** ```text Vote(u,s) = (11 βˆ’ p(u,s)) Γ— [1 + S(u) Γ— (√FS(u) + F(u) + P(u,s))] Γ— E(u,s) ``` ### 3.1 Variables | Symbol | Definition | Version 1.0 rule | |--------|------------|------------------| | u, s | User and song | One eligible Top 10 per user; one placement per song. | | p(u,s) | Rank position | Integer 1 through 10. | | 11 βˆ’ p | Rank points | 10 for #1, 9 for #2, …, 1 for #10. | | S(u) | Superfan activation switch | 1 when an active Superfan-or-higher entitlement is in force; otherwise 0. | | FS(u) | Fan Score | Visible total from the Version 1.0 point registry. | | √FS(u) | Fan Activity Units | Exact non-negative square root of Fan Score. | | F(u) | Verified Follower Units | Sum of all qualifying Bandruption follows after 30-day linear vesting. No hard cap. | | P(u,s) | Playlist Proof Units | Sum of supported services where the song is verified in a user-controlled playlist after 7-day linear vesting; max one unit per service. | | E(u,s) | Integrity eligibility | 1 when the contribution is eligible; 0 when excluded. Pending reviews are withheld until resolved. | ### 3.2 Individual vote ```text R(u,s) = 11 βˆ’ p(u,s) M(u,s) = 1 + S(u) Γ— [√FS(u) + F(u) + P(u,s)] Vote(u,s) = R(u,s) Γ— M(u,s) Γ— E(u,s) ``` If S = 0, the bracketed earned inputs are inactive and M = 1. If S = 1, those inputs become active. The baseline 1 remains in both cases. ### 3.3 Verified follower units ```text F(u) = Ξ£_j Q(j) Γ— min[1, days_following(j,u) Γ· 30] ``` The sum runs across every fan j who follows user u inside Bandruption. Q(j) equals 1 when the follower meets the published qualification standard and 0 otherwise. There is no division by the number of Superfans the follower supports, and there is no lifetime following limit. An unfollow sets that relationship's contribution to 0 at the next calculation. ### 3.4 Playlist proof units ```text P(u,s) = Ξ£_k C(u,s,k) Γ— min[1, days_verified(u,s,k) Γ· 7] ``` The sum runs across supported streaming services k. C equals 1 when Bandruption can verify, with user authorization, that song s is in a playlist controlled by user u on service k; otherwise it equals 0. Several playlists on the same service still produce only one service unit for that song. ### 3.5 Song totals and time windows ```text LiveScore(s,t) = Ξ£_u Vote(u,s,t) PeriodScore(s,W) = (1 / |W|) Γ— Ξ£_{t ∈ W} LiveScore(s,t) ``` The live score is the sum of all eligible current contributions at snapshot time t. Bandruption records hourly snapshots. A Today, Week, Month, or Year view uses the arithmetic mean of the hourly live scores in that window, with missing or not-yet-present hours contributing zero. This rewards sustained support through repeated presence in the window rather than through a separate age multiplier. ### 3.6 Rounding and tie-breakers - Calculations use full precision. The public interface may display two decimals. - First tie-breaker: more unique eligible fans ranking the song in the selected window. - Second tie-breaker: more eligible #1 placements in the selected window. - Third tie-breaker: the song that first attained the tied score ranks higher. - Track identity uses service IDs and, where available, ISRC and release metadata. Distinct live, remastered, or alternate recordings remain separate unless Bandruption publicly merges them as the same canonical recording. ## 4. Mathematical Behavior ### 4.1 Follower influence is linear, unbounded, and easy to audit Holding rank, Fan Score, playlist proof, subscription status, and eligibility constant, an additional fully vested follower changes a Superfan's vote by exactly the rank points of that song: ```text Ξ”Vote for one additional full follower = 11 βˆ’ rank ``` The #1 song rises by 10; #5 rises by 6; #10 rises by 1. Because F is a direct sum, it has no product-set ceiling and no asymptote. At a given moment, one Superfan can receive at most one follow from each other qualified Bandruption account, so the practical maximum is the size of the qualified community. Growth remains possible as that community grows. (Illustrative charts in the published whitepaper end at 1,000 followers only for readability; the line continues without a fixed maximum.) ### 4.2 Fan activity grows forever, but does not grow linearly Fan Score is transformed with a square root. This is a concave function: it remains unbounded, but additional points have diminishing marginal effect. Four times the Fan Score produces twice the activity units. This preserves an incentive to continue valuable work while reducing the risk that a long-tenured or highly transactional user overwhelms the chart through one input alone. Examples: 25 Fan Score β†’ 5 activity units; 100 β†’ 10; 400 β†’ 20; 10,000 β†’ 100. ### 4.3 Why the signals are additive A fully multiplicative formula makes every follower inherit every personal activity and playlist factor. That creates cross-amplification: raising one input increases the value of all other inputs. The result becomes difficult for fans to predict and can explode even when all underlying units are real. (The published whitepaper shows a multiplicative variant only as a mathematical comparison; it is not used by Version 1.0.) The additive formula preserves the intended force multiplication while keeping each unit legible: a follower is one follower unit, a verified service is one playlist unit, and activity is a separate square-root contribution. ### 4.4 Why there is no separate list-age or track-holding bonus Sustained support matters through period snapshots and evidence vesting. A song that remains in many Top 10s for a full week contributes across the full weekly window. A new release can still compete immediately in the live chart. This avoids an additional tenure multiplier that would systematically entrench older lists, older accounts, and older songs. ### 4.5 Why ordinary new fans keep their full baseline ballot A blanket discount on every new account would also discount genuine new fans at the moment the platform most wants them to participate. Version 1.0 instead places friction on the high-impact inputs: follower units vest for 30 days, playlist proof vests for 7, and suspicious contributions can be held for review. The direct 10-to-1 ballot remains available to every eligible fan. ## 5. Fan Score ### 5.1 Public point registry Fan Score is an auditable sum of Fan Points. The point value and eligibility conditions must be visible before a fan performs an action. Connection points remain only while the connection remains active; reversible transactions lose their points after refund, chargeback, cancellation, or fraud reversal. | Verified action | Fan Points | Qualification | Repeat rule | |-----------------|------------|---------------|-------------| | Connect a supported social account | +1 each | OAuth/account control verified | Maximum 4 active connection points. | | Connect a supported streaming service | +1 each | User authorization and token valid | Maximum 4 active connection points. | | Qualified fan referral | +5 | Referred account is 30+ days old, qualifies as a real account, and completes a Top 10 | Once per referred person. Self-referrals excluded. | | Verified concert attendance | +10 | Ticket scan, venue/artist confirmation, or equivalent proof | Once per fan per event. | | Sustained playlist support | +1 | Unique song-service pair verified for 30 consecutive days | Maximum 10 grants in any rolling 30 days. | | Completed artist bounty | +1 / +3 / +5 / +10 / +20 | Published effort band, objective completion evidence, and platform integrity checks | Once per verified bounty claim. | | Completed affiliate order | +2 | Unique non-refunded purchaser and completed order | Once per purchaser-artist pair in a rolling 90 days. Self-dealing excluded. | | Other verified artist-support work | Published effort band | Must map to the same five bounty bands before work begins | Subject to the campaign's public rules and platform approval. | ### 5.2 Fan Score rules - Fan Score is non-negative. Removed or reversed actions subtract the same points they originally added. - One real-world event cannot be re-labeled into several point grants unless the public campaign rules identify genuinely separate work. - A user cannot earn referral or affiliate points from themselves, accounts they control, refunded orders, or circular transactions. - Playlist proof may contribute one song-specific P unit after 7 days and one small general Fan Point after 30 days. This is deliberate: current support helps that song, while sustained curation builds general reputation. - BANDS rewards and Fan Points are separate. The amount of BANDS purchased, held, or spent never becomes Fan Score. - For a bounty, Fan Points are determined by the published effort band and verified work β€” never by the BANDS reward, cash value, artist budget, or subscription tier. - Any new Fan Score action category must be published with its points, verification rule, reversal rule, and effective date before it can affect the chart. ### 5.3 Why use the visible raw Fan Score, then take its square root Fans should be able to inspect the ledger that created their score and reproduce the activity input themselves. Keeping the ledger additive makes it easy to audit; applying the square root only at the chart layer provides the diminishing-return protection without obscuring individual actions. ## 6. Verified Bandruption Following ### 6.1 The central community mechanism A Verified Bandruption Follow is an explicit in-platform relationship between two fan accounts. It is both social and consequential: after qualification and vesting, it adds one follower unit to the followed Superfan's multiplier. Free fans, Superfans, and higher-tier fans may all create qualifying follows. A fan may follow any number of Superfans. The follow strengthens the entire Top 10. That is a feature, not an accident. A fan is endorsing the public taste-maker, not purchasing a vote for only one track. Public lists and immediate unfollowing make that endorsement accountable. ### 6.2 Minimum qualification for a full follower unit - The follower controls a Bandruption account with verified contact information and secure authentication. - The account has existed for at least 7 days and has completed a Top 10. - At least one accepted assurance signal is present: an authorized social account, authorized streaming account, verified event attendance, or an approved alternative identity review. - The follower is not suspended, duplicated, automated, or materially linked to concealed account farming. - The follow was explicitly initiated by the follower, is not a self-follow, and remains active. - The relationship begins accruing after qualification and vests linearly over 30 days. At day 15 it contributes 0.5; at day 30 it contributes 1.0. ### 6.3 Unlimited following, controlled velocity Version 1.0 imposes no lifetime limit and does not divide a fan's support among the accounts they follow. A real fan may connect broadly across a genre, city, scene, or artist community. Bandruption may rate-limit the speed of new follow creation and review abnormal mass-following patterns, but a legitimate fan can continue adding connections over time. ### 6.4 Why external social followers are not the chart unit External platforms can sometimes provide a follower count, a follower list, or both, but access varies by platform, account type, permission, commercial tier, privacy setting, and policy. Raw external counts also include people who have never joined Bandruption and have never consented to influence this chart. Version 1.0 therefore counts only explicit Bandruption follows. A connected X, Instagram, Facebook, or TikTok account may support identity assurance, discovery, or fraud analysis, but an external follower does not become a chart unit until that person joins Bandruption and creates the in-platform follow. ### 6.5 Relationship to fluid representation The revocable and visible relationship resembles fluid representation, but the weights are not conserved. Research on liquid democracy shows both the appeal of delegation and the need to monitor concentration. [\[3\]](#references) [\[4\]](#references) Bandruption's policy choice is explicit: a fan may strengthen several representatives at once because connection and community formation are themselves part of the product. The consequence is also explicit: one fan can create more than one unit of network influence by forming more than one qualified relationship. ## 7. Playlist Proof ### 7.1 What qualifies - The fan has authorized Bandruption to access the relevant service through the service's official authentication flow. - The song appears in a playlist owned or meaningfully controlled by the fan. Merely following an editorial or third-party playlist does not qualify. - The song is matched to the Bandruption track using platform IDs and, when available, ISRC and release metadata. - The song-service pair vests linearly over 7 consecutive verified days. - A service contributes at most one unit for the song, no matter how many playlists contain it. - Removal, lost authorization, or a failed re-check sets the service contribution to zero at the next verification cycle. ### 7.2 Why playlist proof is song-specific A playlist placement is evidence about one song, not the fan's entire ballot. It therefore enters P(u,s), not F(u), and gives no direct bonus to the other nine songs. A small Fan Point after 30 days can recognize long-term curation, but the immediate chart effect stays attached to the verified song. ### 7.3 Supported-service policy A service is enabled only after Bandruption can use an official, user-authorized interface to verify user-controlled playlist contents with acceptable reliability and privacy. Unsupported services contribute zero rather than relying on screenshots, passwords, scraping, or self-attestation. ## 8. Integrity and Anti-Gaming ### 8.1 The threat model Any system that turns accounts or relationships into influence must expect attempts to create many false identities, buy follows, coordinate concealed account farms, recycle transactions, or automate activity. Computer-security literature calls the use of many fabricated identities a Sybil attack. [\[5\]](#references) Research on social networks also shows that connection patterns, target choices, and the responses of legitimate users can help identify fake accounts early, but no single graph test is sufficient in every environment. [\[6\]](#references) ### 8.2 Defense in depth **Account security.** Verified contact information, secure authentication, device/session protection, and account recovery controls. **Progressive identity assurance.** Low-impact participation requires low friction. Accounts that accumulate material chart influence face stronger automated and, when warranted, human review. NIST's digital-identity guidance likewise frames proofing and fraud controls as risk-based assurance rather than one universal burden. [\[7\]](#references) **Time.** Seven-day account minimum, 30-day follow vesting, 7-day playlist vesting, and hourly chart snapshots reduce the value of last-minute account bursts. **Graph analysis.** Shared devices, abnormal IP concentration, synchronized follows, reciprocal rings, repeated target patterns, and clusters of otherwise inactive accounts are reviewed. **Economic and transaction checks.** Self-referrals, self-purchases, circular orders, refunds, chargebacks, and fabricated or duplicate bounty claims do not earn Fan Points. **Rate and velocity controls.** The platform can slow abnormal creation of accounts, lists, follows, and repeated edits without setting a permanent lifetime ceiling. **Human review and appeals.** High-impact or ambiguous cases can be held, reviewed, explained to the affected user, and appealed. ### 8.3 Eligibility instead of opaque authenticity discounts Version 1.0 does not secretly assign every voter a hidden percentage between "real" and "fake." Positive score inputs are public. Integrity status is categorical: eligible contributions count; ineligible contributions do not; pending contributions are withheld while reviewed. Sensitive detection thresholds remain confidential where disclosure would make evasion easier, but the affected user receives a reason category and an appeal path. ### 8.4 Legitimate campaigns are welcome A burst of real fans organizing around a new release, tour, or performance is not manipulation. It is the behavior the chart is designed to reveal. Enforcement targets fabricated identities, automation, undisclosed control, purchased follows, transaction recycling, and deceptive evidence β€” not enthusiastic coordination by genuine people. ## 9. Technical Feasibility of Connected Platforms This capability review is current as of July 16, 2026. Official APIs, access tiers, scopes, review requirements, quotas, and product policies can change. Bandruption treats unsupported or unavailable evidence as zero and does not scrape private accounts or request user passwords. | Platform | Official capability | Version 1.0 use | Important limitation | |----------|---------------------|-----------------|----------------------| | X | User lookup can return public metrics and verification-related fields; Follows endpoints can retrieve follower and following lists. [\[8\]](#references) [\[9\]](#references) | Account-control proof and optional fraud corroboration. Explicit Bandruption follows remain authoritative. | Access, cost, quotas, protected accounts, and policy can limit coverage. | | Instagram | Instagram Graph API exposes account fields for supported professional-account flows, including follower-related metrics in applicable contexts. [\[18\]](#references) | Identity/reputation signal only. | A general portable list of every personal follower is not reliably available for consumer chart matching. | | Facebook | Graph API can expose Page data; user_friends is permission-limited. [\[19\]](#references) [\[20\]](#references) | Identity/reputation signal and possible app-using relationship corroboration. | Personal friend/follower graphs are restricted; not a complete voting roll. | | TikTok | Authorized User Info can return follower_count and related stats. Full followers/following research access is limited to qualifying research programs. [\[16\]](#references) [\[17\]](#references) | Account-control proof and optional count-level risk signal. | Commercial apps should not assume access to full follower lists. | | Spotify | OAuth endpoint lists current-user playlists; playlist-item endpoints expose contents with appropriate scopes. [\[10\]](#references) [\[11\]](#references) | Verify songs in owned or genuinely controlled playlists. | The playlist list includes followed playlists; Bandruption must check ownership/control. Policy and development-mode limits apply. | | Apple Music | MusicKit and Apple Music API support user authorization and library-playlist access through Apple's token model. [\[12\]](#references) [\[13\]](#references) | Verify songs in user-created library playlists where authorization and service access permit. | Requires Apple authorization, token handling, and user/library availability. | | YouTube / YouTube Music | YouTube Data API can list playlists owned by the authenticated user and their playlist items. [\[14\]](#references) [\[15\]](#references) | Verify music videos/tracks in user-owned YouTube playlists. | There is no general separate YouTube Music personal-library API represented by these endpoints; matching music recordings requires care. | | Other services | Enabled only when an official, user-authorized API can verify controlled playlist contents. | One unit per supported service and song. | Screenshots, scraping, and passwords do not qualify. | Official documentation: X [\[8\]](#references) [\[9\]](#references), Spotify [\[10\]](#references) [\[11\]](#references), Apple Music [\[12\]](#references) [\[13\]](#references), YouTube [\[14\]](#references) [\[15\]](#references), TikTok [\[16\]](#references) [\[17\]](#references), Meta [\[18\]](#references) [\[19\]](#references) [\[20\]](#references) ### 9.1 Technical conclusions - Playlist verification is technically feasible for Spotify, Apple Music, and user-owned YouTube playlists, subject to authorization, ownership checks, quotas, platform review, and changing policies. - X provides the strongest documented path among the named social platforms for retrieving both user metrics and follow lists, but Bandruption should still use its own explicit follow graph as the chart source of truth. - TikTok can provide authorized follower counts, while access to full public follower/following lists is positioned within restricted Research Tools rather than a general commercial display flow. - Instagram and Facebook can provide useful account or Page signals in approved contexts, but should not be treated as complete personal-follower registries. - The safest architecture is therefore: external accounts help verify control and evidence; internal Bandruption actions create the actual chart units. ## 10. Subscriptions, BANDS, and Payment Separation ### 10.1 The Superfan switch Superfan or higher changes S from 0 to 1. It activates Fan Activity Units, Verified Follower Units, and Playlist Proof Units. It does not add a fixed paid bonus. A new Superfan with FS = 0, F = 0, and P = 0 still has multiplier 1. Higher paid tiers inherit the same activation but do not receive an additional chart multiplier. This prevents chart power from scaling with subscription price. ### 10.2 BANDS BANDS is Bandruption's closed-loop platform currency. BANDS may be used for eligible platform services, rewards, campaigns, or other published uses. It is not a voting token and is not part of the People's Top Songs equation. - Purchasing BANDS adds 0 to Fan Score. - Holding BANDS adds 0 to Verified Follower Units. - Spending BANDS adds 0 to Playlist Proof Units. - Receiving a BANDS bounty reward does not itself add Fan Points; only the independently verified eligible work can do so. - BANDS cannot be converted into guaranteed chart placement. ### 10.3 Artist campaigns and bounties Artists may use Bandruption bounties and affiliate tools to compensate genuine fans with BANDS rewards for verified participation β€” including featuring a song in a fan's Top 10, meeting a disclosed rank or holding-duration condition, supporting an event, creating approved fan media, making attributable affiliate sales, or completing promotional campaigns β€” and verified bounty completions earn Fan Points under Section 5. > **Earned, revocable influence β€” not purchased chart positions.** Compensating a genuine fan through a disclosed bounty is legitimate participation, not manipulation. Buying, holding, or spending BANDS never adds points directly to a song's score, and neither the presence nor the size of a BANDS reward adds a scoring multiplier or penalty to a fan's ballot. Every compensated ballot remains subject to the same eligibility rules, one-list-per-fan scarcity (10 ranked slots), and community accountability as any other ballot: followers can inspect a Superfan's public Top 10 at any time and unfollow if they disagree with the selections, which removes that follower's contribution at the next hourly snapshot without altering historical snapshots. Sponsored placements or advertisements, if offered, must be labeled and displayed outside the organic People's Top Songs ranking. Third-party streaming and social service requirements remain separate; internal Bandruption bounties do not authorize compensated actions on external services that violate those services' terms. This paper describes product methodology, not a legal opinion about any jurisdiction-specific promotion or payola rule. ## 11. Transparency, Versioning, and Appeals ### 11.1 Fan-visible calculation Each voter should be able to open a score breakdown for every ranked song and see: rank points, Superfan activation, Fan Score, square-root activity units, verified follower units, playlist-proof units, integrity status, and final vote. Each song page should show the aggregate contribution from direct baseline, activity, following, and playlist proof. ### 11.2 Public test vectors Bandruption will maintain fixed examples like those in Appendix A. A production release passes only if the scoring service reproduces those expected values. Machine-readable test vectors may be published alongside the human-readable methodology. ### 11.3 Version changes - Every methodology release receives a version number and effective date. - Formula or point-registry changes are announced publicly before they affect ordinary chart calculations. A target notice period of 30 days applies to non-security changes. - Urgent fraud or security controls may change without advance disclosure when notice would create immediate risk; their public rationale is disclosed afterward when safe. - Historical chart snapshots retain the methodology version used at the time. A later formula does not silently rewrite history. - No individual artist, fan, label, advertiser, or subscriber receives a private scoring formula. ### 11.4 Appeals and corrections A user whose contribution, follower qualification, Fan Points, or playlist proof is removed receives a reason category and may appeal. Confirmed errors are corrected, and withheld contributions may be restored retroactively to the affected snapshots where technically practicable. Material chart corrections are logged publicly. ## 12. Privacy and Data Minimization ### 12.1 Minimum necessary access Bandruption uses official OAuth, MusicKit, or equivalent authorization flows and requests only the scopes needed for the disclosed verification. The platform does not ask fans to provide streaming or social-media passwords. ### 12.2 Evidence, not surveillance - For playlist proof, retain the minimum identifiers and timestamps needed to establish that a song-service pair qualified; avoid retaining a fan's complete listening history when not necessary. - For social verification, retain account identifiers, authorization status, and necessary risk signals; do not treat private messages or unrelated content as chart inputs. - Fans can revoke a connection. When authorization disappears, future evidence from that service stops counting after the next verification cycle. - Public chart breakdowns expose score components, not private account credentials or private playlist contents. - Data-retention periods, deletion rights, and cross-border processing are governed by Bandruption's published privacy policy and applicable law. ### 12.3 Risk-based assurance The identity burden should be proportional to potential impact. A free fan casting a baseline ballot should not face the same process as an account controlling a material share of a global chart. NIST's current digital-identity guidance emphasizes risk management, fraud mitigation, privacy, and multiple assurance levels; Version 1.0 follows that general model without claiming government identity certification. [\[7\]](#references) ## 13. Limitations and Research Agenda ### 13.1 Known limitations - This is not one-person-one-vote. A fan's direct ballot is equal at baseline, but verified activity and network endorsement create additional influence. - Unlimited following means one real fan can strengthen many Superfans. This is intentional, but it can create popularity feedback loops and must be monitored. - A follow amplifies ten songs, including songs the follower may not personally rank. Public lists and revocability are the accountability mechanism. - No verification system can prove perfect uniqueness or eliminate every coordinated fake account. Defense in depth reduces risk rather than making an absolute guarantee. - Connected-platform evidence depends on third-party policies, scopes, review, quotas, and availability. - Square-root Fan Score and vesting periods are design choices that require empirical calibration with real chart behavior. - Early charts with few voters will be volatile and may be dominated by a small number of legitimate participants. Public voter counts are essential context. ### 13.2 Metrics Bandruption should publish or monitor - Share of total chart score attributable to baseline, Fan Score, following, and playlist proof. - Concentration of influence among the top 1%, 5%, and 10% of voters, plus Gini or Herfindahl-style concentration measures. - Number and age distribution of qualified followers; follow creation and unfollow velocity. - Number of artists and songs entering the Top 100 for the first time. - False-positive rate, appeal volume, reversal rate, and time to resolution. - Fraction of playlist checks that fail because of expired authorization, ownership ambiguity, or track-matching errors. - Sensitivity tests showing how rankings would change if each positive input were removed. ### 13.3 How Version 1.0 should evolve The first response to suspicious concentration should be stronger assurance, longer vesting for risky relationships, better graph analysis, rate controls, and clearer discovery surfaces β€” not an arbitrary hard cap on genuine followers. If evidence later shows that linear community amplification consistently prevents healthy chart diversity, any mathematical adjustment must be proposed publicly, tested against historical snapshots, and released as a new version. Possible research variants include different concave transforms for Fan Score, risk-tiered follower vesting, genre or regional charts, diversity-aware discovery modules outside the organic score, and separate "direct preference" and "community momentum" views. None of these variants changes Version 1.0 unless formally adopted. ## Conclusion People's Top Songs turns a fan's music identity into a public, reproducible signal. Every fan begins with a complete ranked ballot. Superfans can activate additional weight that comes from visible activity, real people choosing to follow them, and verified support for individual songs across connected playlists. The model deliberately leaves room for communities to grow without a follower ceiling. It protects that openness by making each follow explicit, qualified, time-vested, revocable, and subject to layered anti-fraud controls. It also keeps the mathematics legible: signals add; they do not secretly multiply one another. The result is not a passive popularity counter and not a sale of chart positions. It is an evolving measure of organized, verifiable fandom β€” one in which fans can see how they matter, artists can see where committed support exists, and every participant can audit the rules. > **Version 1.0 in one sentence.** Every fan gets a 10-to-1 Top 10 ballot; Superfan status activates an uncapped but verifiable combination of square-root Fan Score, linear Bandruption followers, and song-specific playlist proof β€” while BANDS and other purchases remain outside the score. ## Appendix A: Public Test Cases These examples are **normative** calculation checks for Version 1.0. | Test | Inputs | Expected result | |------|--------|-----------------| | A1. Free fan at #1 | p=1, S=0, E=1 | Vote = 10 Γ— [1 + 0] Γ— 1 = 10 | | A2. Superfan switch alone | p=1, S=1, FS=0, F=0, P=0, E=1 | Vote = 10 Γ— [1 + (0+0+0)] = 10 | | A3. Fan Score 25 | p=1, S=1, FS=25, F=0, P=0 | √25=5; Vote = 10 Γ— (1+5) = 60 | | A4. 20 verified followers | p=1, S=1, FS=25, F=20, P=0 | Vote = 10 Γ— (1+5+20) = 260 | | A5. 100 followers and two services | p=1, S=1, FS=100, F=100, P=2 | √100=10; Vote = 10 Γ— (1+10+100+2) = 1,130 | | A6. Same account at #5 | p=5, same inputs as A5 | Rank points=6; Vote = 6 Γ— 113 = 678 | | A7. Follow halfway vested | p=1, FS=25; 20 full follows plus one 15-day follow | F=20.5; Vote = 10 Γ— (1+5+20.5) = 265 | | A8. Playlist halfway vested | p=1, FS=0, F=0; song verified 3.5 days on one service | P=0.5; Vote = 10 Γ— 1.5 = 15 | | A9. Integrity exclusion | Any otherwise valid inputs, E=0 | Vote = 0 | | A10. Free fan follows ten Superfans | Follower is free but qualified; each follow is fully vested | The free fan adds 1 to F for each followed Superfan. If all ten rank the same song #1, network lift = 10 Γ— 10 = 100 points. | | A11. Period average | A song has hourly live scores of 0, 100, 100, and 200 across a four-hour window | PeriodScore = (0 + 100 + 100 + 200) Γ· 4 = 100. A late burst affects only the snapshots after it occurs. | | A12. One follower, ten songs | One full verified follower on a Superfan's complete Top 10 | The list rises by 10 + 9 + … + 1 = 55 total points across all ten songs. The distribution is visible: the strongest increase goes to the song the Superfan ranks first. | ## Glossary **BANDS.** Bandruption's closed-loop platform currency. It has no direct role in the People's Top Songs score. **Baseline ballot.** The 10-to-1 ranked contribution available to every eligible fan. **Fan Activity Units.** The square root of the visible Fan Score. **Fan Point.** A unit awarded under the published Fan Score registry for a verified eligible action. **Fan Score (FS).** The visible sum of active and retained Fan Points. **Integrity eligibility (E).** A categorical input: 1 when a contribution is eligible and 0 when excluded. **Live score.** The sum of all eligible current votes at a snapshot time. **Network endorsement.** The social and chart effect created by following a Superfan inside Bandruption. **Period score.** The arithmetic mean of hourly live scores over the selected time window. **Playlist Proof Unit (P).** A vested service-level unit showing that a ranked song is present in a user-controlled playlist. **Rank points.** 11 minus the list position: 10 points at #1 through 1 point at #10. **Superfan activation switch (S).** The value 1 for an active Superfan-or-higher account and 0 otherwise. **Verified Bandruption Follow.** An explicit in-platform follow from a qualified account, vesting linearly over 30 days and revocable by unfollowing. **Verified Follower Units (F).** The sum of all qualifying, vested Bandruption follows received by a Superfan. ## References Platform capabilities are subject to current terms, permissions, review, quotas, and change. 1. Bandruption, *People's Top Songs* β€” [bandruption.fun/en/top-songs](https://bandruption.fun/en/top-songs) 2. U.S. Department of Justice, *North Carolina Musician Charged With Music Streaming Fraud Aided by Artificial Intelligence* (Sept. 4, 2024) β€” [justice.gov](https://www.justice.gov/usao-sdny/pr/north-carolina-musician-charged-music-streaming-fraud-aided-artificial-intelligence) 3. GΓΆlz, Kahng, Mackenzie & Procaccia, *The Fluid Mechanics of Liquid Democracy* β€” [arxiv.org/abs/1808.01906](https://arxiv.org/abs/1808.01906) 4. Berinsky et al., *Tracking Truth with Liquid Democracy* β€” [arxiv.org/abs/2107.11868](https://arxiv.org/abs/2107.11868) 5. John R. Douceur, *The Sybil Attack* β€” [microsoft.com/en-us/research](https://www.microsoft.com/en-us/research/publication/the-sybil-attack/) 6. Breuer, Eilat & Weinsberg, *Friend or Faux: Graph-Based Early Detection of Fake Accounts on Social Networks* β€” [arxiv.org/abs/2004.04834](https://arxiv.org/abs/2004.04834) 7. NIST SP 800-63, Revision 4, *Digital Identity Guidelines* β€” [pages.nist.gov/800-63-4](https://pages.nist.gov/800-63-4/) 8. X API: Get User by ID β€” [docs.x.com](https://docs.x.com/x-api/users/get-user-by-id) 9. X API: Follows β€” [docs.x.com](https://docs.x.com/x-api/users/follows) 10. Spotify Web API: Get Current User's Playlists β€” [developer.spotify.com](https://developer.spotify.com/documentation/web-api/reference/get-a-list-of-current-users-playlists) 11. Spotify Web API: Get Playlist Items β€” [developer.spotify.com](https://developer.spotify.com/documentation/web-api/reference/get-playlists-items) 12. Apple Music API: Get All Library Playlists β€” [developer.apple.com](https://developer.apple.com/documentation/applemusicapi/get_all_library_playlists) 13. MusicKit: Requesting User Authorization for Apple Music β€” [developer.apple.com](https://developer.apple.com/documentation/musickit/requesting_user_authorization_for_apple_music) 14. YouTube Data API: Playlists.list β€” [developers.google.com](https://developers.google.com/youtube/v3/docs/playlists/list) 15. YouTube Data API: PlaylistItems.list β€” [developers.google.com](https://developers.google.com/youtube/v3/docs/playlistItems/list) 16. TikTok API v2: Get User Info β€” [developers.tiktok.com](https://developers.tiktok.com/doc/tiktok-api-v2-get-user-info) 17. TikTok Research Tools β€” [developers.tiktok.com](https://developers.tiktok.com/products/research-api/) 18. Meta Instagram Graph API: IG User β€” [developers.facebook.com](https://developers.facebook.com/docs/instagram-api/reference/ig-user) 19. Meta Graph API: User Friends β€” [developers.facebook.com](https://developers.facebook.com/docs/graph-api/reference/user/friends) 20. Meta Graph API: Page β€” [developers.facebook.com](https://developers.facebook.com/docs/graph-api/reference/page) --- *People's Top Songs β€” Public Scoring Methodology β€” Version 1.0 β€” July 2026* --- ## Music Industry Overview Source HTML: https://docs.bandruption.fun/docs/music-industry/overview Markdown alternate: https://docs.bandruption.fun/markdown/docs/music-industry/overview.md # Music Industry Overview Music industry companies and professionals β€” labels, agencies, studios, promoters, and more β€” can create a presence on Bandruption, connect with artists, and engage their own audiences through subscriptions and events. ## Feature Summary | Feature | Description | |---------|-------------| | [Profile](#profile-management) | Public page for your company or organization | | [Subscriptions](./subscriptions.md) | Member subscription tiers with exclusive access | | Events | Host industry events (see [Events](../events/overview.md)) | | Ticketing | Sell or gate tickets to events (see [Ticketing](../ticketing/overview.md)) | --- ## Profile Management Your music industry profile is your public-facing page on Bandruption, separate from individual artist profiles. ### What you can configure - **Company name and title** β€” Display name shown on your profile - **Bio and description** β€” Describe your organization and what you offer - **Avatar and banner images** β€” Upload a logo and banner for your page - **Genre and focus area tags** β€” Help fans and artists discover you - **Social media links** β€” Link to Instagram, Twitter/X, website, and more ### Getting a Music Industry Profile New industry profiles go through an approval process similar to artist profiles: 1. Sign in to [bandruption.fun](https://bandruption.fun) 2. Open your **Dashboard** and go to the **Profile** tab 3. Submit a music industry application with your organization details 4. The Bandruption team reviews and approves your application Once approved, your profile is publicly visible at `bandruption.fun/industry/` and you can create subscriptions and events. --- ## Next Steps - [Set up member subscriptions](./subscriptions.md) - [Create an event](../events/overview.md) - [Manage event ticketing](../ticketing/overview.md) --- ## Ticketing Overview Source HTML: https://docs.bandruption.fun/docs/ticketing/overview Markdown alternate: https://docs.bandruption.fun/markdown/docs/ticketing/overview.md # Ticketing Overview Every Bandruption event can have multiple ticket types, each with its own price, availability window, subscriber discount, and access rules. Fans receive a unique ticket code upon purchase or RSVP. ## Feature Summary | Feature | Description | |---------|-------------| | Ticket Types | Create multiple tiers per event (General, VIP, RSVP, etc.) | | Pricing | Set base price and optional subscriber member price | | Sales Windows | Control when tickets go on sale and stop selling | | Subscription Access Control | Require a subscription tier to purchase a ticket | | One-Click RSVP | Free ticket reservation with a single click | | Collectible Ticket Designs | Artist-provided artwork combined with AI-generated design to create collectible ticket variants | | [Purchasing Tickets](./purchasing-tickets.md) | How fans buy and access their tickets | --- ## Ticket Types Each ticket type represents a distinct category of admission for your event. You can add as many ticket types as you need. ### Creating a Ticket Type From your event admin page, go to **Ticket Types β†’ Add Type**. | Field | Description | |-------|-------------| | **Name** | Ticket name shown to fans (e.g. "General Admission", "VIP", "Backstage") | | **Description** | Optional details about what this ticket includes | | **Price** | Ticket price. Set to `0` for a free/RSVP ticket | | **Quantity** | Total tickets available for this type | | **Max per user** | Maximum number of tickets one fan can purchase | | **Image** | Artist-provided artwork used for the ticket and its collectible variants | --- ## Pricing ### Standard Pricing Set a base price for each ticket type. Prices support multiple currencies. ### Member Pricing (Subscriber Discount) You can set a discounted **member price** for subscribers: - Enter a **member price** lower than the standard price - Set a **member price max quantity** β€” the maximum number of discounted tickets a single subscriber can purchase - Subscribers see the discounted price automatically when viewing the event --- ## Sales Windows Control the exact period during which tickets are available for purchase: | Setting | Description | |---------|-------------| | **Sales start date** | Tickets become purchasable at this date/time | | **Sales end date** | Tickets stop selling after this date/time | If no sales window is set, tickets are available from the moment the event is published until the event date. --- ## Subscription Access Control You can require fans to hold an active subscription before they can purchase a specific ticket type: - Go to the ticket type settings and select **Required Subscription Tiers** - Fans without a qualifying subscription will see the ticket but will be prompted to subscribe first - This can be set at the event level (applies to all ticket types) or at the individual ticket type level --- ## One-Click RSVP For free events or free ticket types, you can enable **One-Click RSVP**: - Fans claim their ticket with a single button press β€” no payment flow required - Ideal for virtual events, free shows, or fan meetups --- ## Collectible Ticket Designs Bandruption combines human-created, artist-provided artwork with AI-generated design to produce collectible ticket variants for each ticket type. The artwork is human-created; AI contributes generated design elements and ticket styling: - Artist-provided artwork supplies the human artwork for the ticket - AI contributes generated design elements and ticket styling based on the event and ticket type details - Each resulting ticket design is displayed on the ticket card shown to fans - Artists can supply or update their human-created artwork for any ticket type --- ## Next Steps - [How fans purchase and access tickets](./purchasing-tickets.md) --- ## Bounties Source HTML: https://docs.bandruption.fun/docs/artists/bounties Markdown alternate: https://docs.bandruption.fun/markdown/docs/artists/bounties.md # Bounties Bounties are paid or points-based fan actions. Use them when you want fans to do a specific job: share a release, attend an event, add a song to a playlist, feature or hold a song in their Bandruption Top 10, buy merch, or submit proof of another action. Active bounties can be discovered on Bandruption's public bounty pages, and admins manage them from **Admin β†’ Bounties**. ## Good Bounty Examples | Goal | Bounty setup | Suggested reward | |------|--------------|------------------| | Release-week sharing | Criterion: **Share resource**. Note: "Post the new single link to Instagram Stories, tag the artist, and upload a screenshot." | 100 loyalty points or a supporter badge | | Drive ticket sales | Criterion: **Purchase ticket**. Target type: **Event**. Target ID: the event slug or ID. | Ticket upgrade raffle entry | | Build playlist reach | Criterion: **Add playlist**. Target type: **Song**. Target ID: the song slug or ID. | Discount code or exclusive content | | Feature a track in Top 10 | Criterion: **Add song to Top 10** or **Hold song in Top 10**. Target type: **Song**. Target ID: the song slug or ID, with optional rank or holding duration parameters. | BANDS reward or loyalty points | | Reward street team work | Criterion: **External verification**. Note: "Put up one approved poster and upload a photo with location." | Merch item or custom perk | | Grow social following | Criterion: **Follow artist**. Target type: **Artist**. Target ID: the artist username. | 50 loyalty points | ## Field Guide | Field | What to enter | Example | |-------|---------------|---------| | **Title** | A short fan-facing action statement | `Share our new single on Instagram` | | **Description** | What the fan must do and what proof they should submit | `Post the track link in a story, tag the artist, and submit a screenshot.` | | **Genre** | Optional discovery label | `J-pop`, `punk`, `hip-hop` | | **Completion logic** | Whether all criteria must be met or any one criterion is enough | `All criteria` for multi-step tasks | | **Start Date** | Optional first day claims can start | Leave blank for immediate launch | | **End Date** | Optional last day claims can be submitted | Use a release-week or event deadline | | **Max Claims** | Optional total claim cap | `50` for a limited campaign | | **Minimum Completion Time** | Seconds a fan must wait before completion | `300` to require at least five minutes | | **Fraud Risk Limit** | Optional score ceiling from 0 to 1 | `0.35` for a stricter review threshold | ## Criteria Criteria define what the fan must prove. - Use **Target type** when the action is about a specific object, such as an event, song, merch item, playlist, artist, or venue. - Use **Target ID** for the object's Bandruption ID, slug, or username. - Use **Instructions / note** for fan-facing proof instructions and reviewer context. Common pairs: | Criterion type | Target type | Target ID example | Note example | |----------------|-------------|-------------------|--------------| | Purchase ticket | Event | `event_tokyo_release_party` | `Buy any ticket for the release party.` | | Add playlist | Song | `song_new-single` | `Submit a screenshot showing the song in your playlist.` | | Add song to Top 10 | Song | `song_new-single` | `Add the track to your public Bandruption Top 10.` | | Hold song in Top 10 | Song | `song_new-single` | `Keep the track in your public Bandruption Top 10 for at least 7 days.` | | Share resource | No target | Leave blank | `Share the campaign link and upload a screenshot.` | | External verification | Venue | `venue_shimokitazawa-basementbar` | `Upload a photo of the approved poster at the venue.` | ## Rewards Rewards define what the fan gets after approval. | Reward type | Amount | Title | Code | Note | |-------------|--------|-------|------|------| | Loyalty points | `100` | Leave blank | Leave blank | `Auto-awarded after approval.` | | Discount code | `10` | `Street team discount` | `STREETTEAM10` | `Applies to merch this month.` | | Perk voucher | Leave blank | `Release-week supporter badge` | Leave blank | `Send voucher after claim approval.` | | Custom | Leave blank | `Signed setlist raffle entry` | Leave blank | `Add approved fans to the raffle sheet.` | ## Review Workflow 1. Create the bounty in **Admin β†’ Bounties β†’ Campaigns**. 2. Fans claim it and submit proof. 3. Review pending claims in **Admin β†’ Bounties β†’ Claim Review**. 4. Approve only when the evidence matches the criterion notes. 5. Reject claims with missing, unclear, or mismatched proof. Avoid vague bounties like "support the artist." A good bounty has one visible fan action, one proof requirement, and one clear reward. --- ## Loyalty Programs Source HTML: https://docs.bandruption.fun/docs/artists/loyalty-programs Markdown alternate: https://docs.bandruption.fun/markdown/docs/artists/loyalty-programs.md # Loyalty Programs Bandruption's loyalty system gives you a powerful way to reward your most dedicated fans. Fans earn points for every dollar they spend, and those points accumulate into tiers that unlock better rewards. ## How the Points System Works Fans earn loyalty points on every qualifying purchase or completed activity: - **Merchandise** purchases - **Subscription** payments - **Ticket** purchases - **Bounty** completions The points-per-dollar rate increases automatically as fans reach higher tiers. ## Loyalty Tiers Every loyalty program has four automatic tiers based on cumulative annual spending: | Tier | Minimum Annual Spend | Points per Dollar | |------|---------------------|-------------------| | Fan | $0 | 3 pts / $1 | | Super Fan | $200 | 4 pts / $1 | | Backstage | $500 | 5 pts / $1 | | VIP | $1,000 | 6 pts / $1 | Fans are automatically promoted as their cumulative annual spend crosses each threshold. ## Bounty Point Awards Bounties are managed from **Admin β†’ Bounties** because they can award loyalty points, vouchers, discounts, merch, or custom perks. See [Bounties](./bounties.md) for bounty examples, field guidance, and the claim review workflow. ## Redemptions Redemptions are rewards fans can exchange their loyalty points for. You define what's available and how many points each reward costs. ### Types of Rewards - Exclusive merchandise or digital downloads - Meet-and-greet experiences - Backstage passes or special access - Any custom reward you want to offer ### Creating a Redemption Go to **Loyalty β†’ Redemptions** and click **Create Redemption**. | Field | Description | |-------|-------------| | **Title** | Name of the reward | | **Description** | Details about what the fan receives | | **Points cost** | How many points a fan must spend | | **Quantity available** | Optional cap on how many fans can redeem it | | **Image** | Optional photo of the reward | ## Loyalty Analytics The analytics dashboard shows you: - Total points issued vs. redeemed - Fan distribution across tiers - Bounty claim rates - Revenue attributed to loyalty program engagement --- ## Merchandise Source HTML: https://docs.bandruption.fun/docs/artists/merchandise Markdown alternate: https://docs.bandruption.fun/markdown/docs/artists/merchandise.md # Merchandise Bandruption lets you run a full merchandise store directly from your artist profile. You can sell physical goods (shirts, vinyl, posters) as well as digital products (downloads, sample packs, PDFs). ## Adding Products Go to **Admin β†’ Products** in your artist dashboard and click **Add Product**. ### Product Fields | Field | Description | |-------|-------------| | **Title** | Product name shown to fans | | **Description** | Full product description | | **Price** | Listed price in your selected currency | | **Category** | e.g. Apparel, Accessories, Digital, Music | | **Featured image** | Main product photo | | **Additional images** | Up to several gallery photos | | **Inventory count** | Starting stock quantity | | **Low stock threshold** | Alert threshold for restocking reminders | | **Digital file** | For digital products, attach a downloadable file | | **Published** | Whether the product is visible in your store | ## Inventory Tracking Bandruption tracks stock levels automatically: - Inventory decrements when an order is completed - You receive alerts when stock drops below your configured threshold - Out-of-stock products are automatically hidden from purchase ## Digital Products For digital downloads, fans receive an instant download link after purchase. You can attach any file type (MP3, WAV, ZIP, PDF, etc.). ## Loyalty Points on Purchases Fans earn loyalty points on all merchandise purchases. The number of points is based on the purchase amount and the fan's current [loyalty tier](./loyalty-programs.md). ## Earnings Merchandise revenue is tracked in your earnings dashboard as gross sales. Payout reconciliation and settlement are handled outside the product, so Bandruption no longer exposes an in-app automatic payout processor or payout threshold workflow. --- ## Subscriptions Source HTML: https://docs.bandruption.fun/docs/artists/subscriptions Markdown alternate: https://docs.bandruption.fun/markdown/docs/artists/subscriptions.md # Subscriptions Artist subscriptions let fans join a recurring fan club and unlock exclusive content and perks. Subscriptions are billed monthly through PayPal and can be set up with multiple tiers. ## How Subscriptions Work 1. You create one or more subscription tiers from your artist dashboard 2. Fans browse your tiers and choose one to join 3. PayPal handles recurring billing each month 4. Subscribers automatically gain access to members-only content ## Creating a Subscription Tier From your artist admin panel, go to **Subscriptions** and click **Create Tier**. ### Fields you can configure | Field | Description | |-------|-------------| | **Name** | Tier name displayed to fans (e.g. "Fan Club", "VIP Access") | | **Description** | Short summary of what this tier includes | | **Price** | Monthly price in USD (or your selected currency) | | **Loyalty Points** | Points fans earn per billing cycle | | **Features list** | Bullet-point list of perks displayed on the tier card | | **Image** | Optional tier artwork | | **Free trial** | Enable a free trial period (e.g. 7 days) for new subscribers | | **Published** | Toggle whether the tier is visible to fans | ## Members-Only Content Once a fan subscribes, they unlock access to any content you have marked as members-only. Supported content types include: - πŸ“· **Photos** - 🎬 **Videos** - 🎡 **Audio files** - πŸ“₯ **Downloadable files** (PDFs, ZIP archives, etc.) You manage members-only content from the **Members Content** section of your artist dashboard. ## Subscription-Gated Events You can restrict event access to specific subscription tiers. See [Ticketing β€” Access Control](../ticketing/overview.md#subscription-access-control) for details. ## Free Trial Periods You can offer a free trial for any subscription tier. When enabled: - New subscribers can join without being charged for the trial period (e.g. 7 days) - After the trial, regular billing begins automatically - Fans have full member access during the trial ## Subscriber Management From your dashboard you can: - View the list of active and past subscribers - See subscriber spend and loyalty point totals - Monitor next billing dates and renewal status --- ## Bandruption MCP Connector Source HTML: https://docs.bandruption.fun/docs/developers/mcp Markdown alternate: https://docs.bandruption.fun/markdown/docs/developers/mcp.md # Bandruption MCP Connector Bandruption hosts a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server at **`https://mcp.bandruption.fun/mcp`**. Adding it as a connector lets Claude, Grok, or any MCP-aware assistant read your artist context and run admin operations on your behalf, with you in the loop for every change. > **Status:** OAuth 2.1 + PKCE is live on the production MCP endpoint. Keep this page synchronized with the currently deployed transport, scope, and tool surface. > **Host migration:** the former `.com` endpoint and OAuth audience are retired. Remove the old connector and re-register it with the `.fun` URL; old registrations and tokens are not accepted on the new audience. ## What you can do with it Once the connector is added and you've signed in, your assistant can: - **Read your data** β€” fetch artist context (profile, loyalty program, counts), event lists, affiliate summaries, and bounty details. - **Run your fan-engagement programs** β€” create, update, archive, and review claims on loyalty bounties for the artists or music-industry profiles you own. - **Set up events and ticketing** β€” create draft events, add ticket types with pricing, capacity, and member-only options. - **Manage your storefront** β€” create merch products with pricing, inventory, and variants. Every write tool requires you to confirm the action in chat before it executes. Your assistant proposes the change first; you approve. ## What you can't do (yet) The MCP exposes admin operations only β€” the same actions you could perform in Bandruption's web admin. It does not: - Transfer money, take card payments, or pay anyone out β€” the only spend is BANDS (Bandruption's in-app credit) from your own balance when you confirm `social.publish_post`, after a dry run that shows the cost - Generate AI images or audio - Access fan personal data outside your audit reach - Modify other artists you don't own ## Add the connector to Claude Bandruption admits MCP clients by URL. Claude, Claude Code, and other MCP clients identify themselves with a Client ID Metadata Document (an `https://` client ID hosted by the assistant's vendor); Bandruption's authorization server fetches, validates, and remembers that document. There is nothing to paste and there is no client secret. Clients that cannot present a metadata URL register automatically instead (RFC 7591). Either way the client is limited to the MCP server and the `mcp:admin` scope. ### Claude.ai (web) 1. Open **Settings β†’ Connectors β†’ Add custom connector**. 2. Enter `https://mcp.bandruption.fun/mcp` as the URL. Leave **Advanced settings** empty. 3. Click **Connect**. You'll be redirected to Bandruption to sign in (or jump straight to consent if you signed in within the last 15 minutes; otherwise you sign in again). The consent page names the client **Claude (claude.ai)**. 4. Review the requested access (admin scope on the artists you own) and click **Approve**. 5. The connector is now available in any chat. Try: _"List my active bounties on \."_ A connector created earlier with the static client ID `mcp_client_22199e09-0f81-4d37-bd57-84e48b36318f` in **Advanced settings** keeps working; you can also remove it and add it again by URL alone. ### Claude Code Run: ```bash claude mcp add --transport http bandruption https://mcp.bandruption.fun/mcp ``` then type `/mcp` inside Claude Code and choose **Authenticate**. Claude Code opens your browser and receives the code on a loopback redirect; the consent page names the client **Claude Code (claude.ai)**. ### Claude Desktop 1. Open **Settings β†’ Developer β†’ Edit Config**. 2. Add the Bandruption server to the `mcpServers` block: ```json { "mcpServers": { "bandruption": { "url": "https://mcp.bandruption.fun/mcp" } } } ``` 3. Restart Claude Desktop. The OAuth flow runs in your browser the first time you call a Bandruption tool; Claude Desktop presents its metadata URL, so no client ID is needed. Connectors added on claude.ai are also available in Claude Desktop when you are signed in to the same account. ### Grok (grok.com) 1. Open [grok.com/connectors](https://grok.com/connectors). 2. Click **New Connector**, then select **Custom**. 3. Enter `https://mcp.bandruption.fun/mcp` as the MCP server URL. 4. Complete Bandruption sign-in and consent when prompted. Grok registers as a public OAuth client (PKCE) and returns to `https://grok.com/connectors-oauth-exchange-code/`. 5. The connector is then available in Grok chats. Try: _"List my active bounties on \."_ ### Other MCP-aware clients Any client that implements the MCP Authorization spec (OAuth 2.1 with PKCE) can connect. Clients that publish a Client ID Metadata Document are admitted by URL; clients that do not can register at the advertised `registration_endpoint` (RFC 7591) as a public client with PKCE. Registration is credential-free: send `token_endpoint_auth_method` as `none` (or `private_key_jwt`), because dynamically admitted clients are never issued a client secret. Loopback redirects (`http://127.0.0.1:/callback`) and private-use schemes are recognised as native automatically, so bridges such as `mcp-remote` need no `application_type`; a private-use scheme must be a reverse-domain name with no naming authority (`com.example.app:/callback`, not `com.example.app://callback`). Both kinds are limited to the MCP server (`resource=https://mcp.bandruption.fun/mcp`) and the `mcp:admin` scope: they cannot request the platform API or machine-to-machine grants. A client that needs anything else still goes through a reviewed registration β€” ask [support@bandruption.fun](mailto:support@bandruption.fun). - **Server URL:** `https://mcp.bandruption.fun/mcp` - **Authorization Server discovery:** the server returns `WWW-Authenticate: Bearer resource_metadata="https://mcp.bandruption.fun/.well-known/oauth-protected-resource"` on an unauthenticated request; that document names the authorization server `https://auth.bandruption.fun`, whose metadata lives at `https://auth.bandruption.fun/.well-known/oauth-authorization-server` - **Canonical OAuth resource:** `https://mcp.bandruption.fun/mcp` - **Compatibility note:** older clients that still send `https://mcp.bandruption.fun` are accepted during rollout, but Bandruption normalizes tokens to the canonical `/mcp` audience - **Required scope:** `mcp:admin`, with `resource=https://mcp.bandruption.fun/mcp` ## What the assistant sees The server exposes: ### Read tools | Tool | What it does | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `bounty.list` | List bounties for an artist or industry entity, filtered by criterion type, reward type or active state | | `bounty.get` | Fetch a single bounty by ID | | `artist.search` | Find activated artists, unactivated Bandruption shells and Spotify candidates, with their platform status and usable identifiers | | `venue.search` | Find a venue username to pass as `event.create` `venue.industryName` | | `social.connection_status` | List the entity's connected social platforms and public handles; never returns tokens | | `asset.get_download` | Verify a durable asset against the current payer and entity, then return a generation-bound download URL valid for ten minutes | ### Write tools All write tools require explicit `confirmed: true`. | Tool | What it does | | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | `uploads.create_signed_url` | Mint a Bandruption-managed upload URL for profile media and return the `filePath` you can reuse in `entity.update_profile` | | `entity.update_profile` | Update an artist or music-industry profile, including avatar paths returned by `uploads.create_signed_url` | | `entity.update_tabs` | Replace the order, enabled state and default selection of a profile tab configuration | | `event.create` | Draft an in-person or virtual event | | `event.update` | Preview or update event details, and replace the poster or ordered gallery using durable asset IDs | | `event.publish` | Toggle an event between draft and live | | `event.attach_asset` | Add a poster or gallery image to an event: begin an upload bound to the event, then verify and attach it (see below) | | `artist.resolve_event_guest` | Preview or resolve an existing, Spotify or manual guest candidate to the username `event.create` and `event.update` accept | | `ticket_type.create` | Add a ticket type to an event, with price, currency, capacity, sales window and member-only pricing | | `merch.create` | Add a merch product to an artist's storefront, with price, inventory, variants and category | | `bounty.create` | Create a fan-engagement bounty | | `bounty.update` | Change an existing bounty (criteria and rewards may be replaced) | | `bounty.archive` | Hide a bounty from fans and stop accepting claims | | `bounty.add_criterion` | Append a criterion to a bounty | | `bounty.add_reward` | Append a reward to a bounty | | `bounty.approve_claim` | Approve a fan's bounty claim | | `bounty.reject_claim` | Reject a fan's bounty claim | | `content.asset.create` | Record platform-owned metadata for a generated content or campaign asset | | `social.compose_post` | Compose a draft post for one of the entity's artifacts (bounty, event, merch, Top 10) on a connected platform | | `social.publish_post` | Publish that post. **This debits BANDS from your balance**; the dry run shows the cost first | For entity-scoped MCP tool arguments, use lowercase public `entityType` values: - `artist` - `music_industry` Older draft examples that showed uppercase enum constants (`ARTIST`, `MUSIC_INDUSTRY`) are not the public MCP contract. ### Event posters and gallery images Event images are part of the event, not free-standing uploads: the raw `filePath` from `uploads.create_signed_url` is not accepted by the event tools. Use `event.attach_asset` on an event you administer, in two phases: 1. `event.attach_asset` with `eventId`, `role` (`POSTER` or `GALLERY`) and `upload: { fileName, contentType, byteSize, sha256 }` (`confirmed: true`). The server mints a PENDING asset owned by you and bound to that event and returns `assetId`, `uploadUrl`, `method: "PUT"`, `requiredHeaders` and `expiresAt` (15 minutes). 2. PUT the bytes to `uploadUrl` with exactly `requiredHeaders`. 3. `event.attach_asset` again with the same `eventId` and `role` plus the returned `assetId` (`confirmed: true`). The server verifies the uploaded object against the declared size and SHA-256, marks the asset READY and attaches it. Preview any step with `confirmed: false`; the attach preview reports `objectUploaded` so you can tell whether the PUT has landed. Images are `image/jpeg`, `image/png`, `image/webp` or `image/gif`, up to 10 MiB. `event.create.posterAssetId` and `event.update.posterAssetId` accept READY asset IDs, so create the event first and add the poster through `event.attach_asset`. Validation failures (a bad `googleMapsUrl`, a malformed `venue.username`, more than ten guests, …) come back as `ok: false` with `error.statusCode: 400` and the field message; `500` means a server fault that is logged with the call's trace id. ### Resources | Resource | Contents | | ---------------------------------------------------------- | -------------------------------------------------- | | `bandruption://admin/artists/{username}/context` | Full artist + loyalty-program snapshot | | `bandruption://admin/artists/{username}/events` | Upcoming and past events | | `bandruption://admin/artists/{username}/affiliate-summary` | Affiliate offering, links, and recent attributions | ## Rate limits and correlation | Bucket | Limit | Applies to | | ----------------------- | ------------------- | ------------------------------------------------- | | Per IP, unauthenticated | 30 requests / 60 s | Discovery, metadata and any call without a bearer | | Per IP, authenticated | 600 requests / 60 s | Any call carrying a bearer token | | Per credential | 300 requests / 60 s | Each individual access token | Exceeding a bucket returns `429` with `Retry-After`. If the limiter's Redis is unavailable the server follows its configured fail mode; production fails **closed**, returning `503` with `Retry-After: 60` rather than admitting unmetered traffic. It never returns a `500` for this. Send `x-bandruption-trace-id` on any request to correlate it with Bandruption's logs when you report a problem. It must be at most 500 characters and match `[A-Za-z0-9][A-Za-z0-9._:/-]*`; anything else is rejected as a bad request. The value is echoed into the audit record for the call. ## Security and privacy - **OAuth 2.1 + PKCE.** Every connection runs through Bandruption's standard sign-in, and access tokens are short-lived (15 minutes) and refreshable until you revoke them. - **You're in control.** Write tools never run without your explicit approval in chat. The server enforces a `confirmed: true` flag on every mutation. - **Scope is yours.** The connector can only act on artists or music-industry profiles you own. It can't read or modify other accounts. - **Audit trail.** Every tool call is logged to your Bandruption account's audit history. View it in the admin dashboard. - **Privacy.** See the [Bandruption Privacy Policy](https://bandruption.fun/en/privacy) for details on how your data is handled. ## Revoke access Open **Settings β†’ Connectors β†’ Bandruption β†’ Disconnect** in your assistant. The next refresh attempt will fail and the access token will expire within 15 minutes. You can also revoke from Bandruption: **Settings β†’ Connected Apps**, find the entry for your assistant, and click **Revoke**. ## Support - **Bug reports / feature requests:** [support@bandruption.fun](mailto:support@bandruption.fun) - **MCP spec:** [modelcontextprotocol.io](https://modelcontextprotocol.io) --- ## Methodology Versions Source HTML: https://docs.bandruption.fun/docs/fans/methodology-versions Markdown alternate: https://docs.bandruption.fun/markdown/docs/fans/methodology-versions.md # Methodology Versions The People's Top Songs chart runs on a published, versioned methodology β€” weight is earned by doing things that help artists, and every rule of it is published **before** it counts. This page is the permanent record: every version of the methodology whitepaper is listed here, newest first. | Version | Status | Published | Summary | Whitepaper | |---------|--------|-----------|---------|------------| | **v1.0** (Public Scoring Methodology) | **Current** | July 2026 | The full People's Top Songs scoring specification: 10-to-1 ranked ballots, the Superfan activation switch, square-root Fan Score, 30-day-vesting Verified Follower Units, 7-day-vesting Playlist Proof Units, integrity eligibility, and payment separation (BANDS never enters the score). | [Read the whitepaper](./top-songs.md) Β· [Download PDF](pathname:///whitepaper/top-songs-en.pdf) | ## How versioning works When the formula changes, the new version is published on this page **before** it takes effect on the live chart. Older versions stay available here permanently, so any historical chart can be read against the exact rules that produced it. ## Live methodology The current version is also maintained as living documentation: - [Top Songs β€” Public Scoring Methodology (v1.0)](./top-songs.md) β€” the full whitepaper: how each vote is scored, amplified, and protected - [Proof of Music Fandom](./proof-of-music-fandom.md) β€” how verified fan actions become a Fandom Score See the chart itself at [bandruption.fun/top-songs](https://bandruption.fun/top-songs). --- ## Proof of Music Fandom Source HTML: https://docs.bandruption.fun/docs/fans/proof-of-music-fandom Markdown alternate: https://docs.bandruption.fun/markdown/docs/fans/proof-of-music-fandom.md # Proof of Music Fandom Proof of Music Fandom is Bandruption's evidence model for direct music fan action. It helps fans show what they have done for artists, and helps artists evaluate committed fans using signals they can act on. The v1 model is not a financial score, investment product, or externally tradeable claim. It is an auditable summary of activity inside Bandruption. ## What The Score Measures Fandom Score is a 0-100 score built from seven categories: | Category | What it measures | Max | | --- | --- | ---: | | Curation | Maintaining a Top 10 song list | 20 | | Attendance | Proof-unlocked event attendance | 25 | | Support | Tickets, merch, and subscriptions | 20 | | Bounties | Completed artist or industry bounties | 15 | | Relationships | Followed artists | 10 | | Competitive | Top 10 battle wins | 5 | | Referrals | Capped share, reach, and conversion signal | 5 | Direct music actions dominate the score. Referral activity can help, but it is capped so viral reach cannot overpower attendance, support, curation, and bounty completion. ## Tiers - Bronze: 0-24 - Silver: 25-49 - Gold: 50-74 - Platinum: 75-100 ## Evidence Bandruption uses evidence already generated by normal product activity: - Top 10 songs - Completed and proof-unlocked event tickets - Completed ticket and merch purchases - Active subscriptions - Completed bounties - Followed artists - Battle wins - Shares, reach, and conversions Public profiles can show selected evidence. Private account surfaces can show the fuller proof artifact, including the generated proof id, timestamp, score breakdown, and evidence counts. ## What This Is Not Proof of Music Fandom does not claim that fandom is permanent, tradeable, financial, or externally complete. It is a practical artist-first metric: a verified view of what a fan has done on Bandruption. --- ## Industry Subscriptions Source HTML: https://docs.bandruption.fun/docs/music-industry/subscriptions Markdown alternate: https://docs.bandruption.fun/markdown/docs/music-industry/subscriptions.md # Industry Subscriptions Music industry profiles can offer subscription tiers for members, clients, or followers who want exclusive access to content, events, and resources. ## How Industry Subscriptions Work Industry subscriptions function the same way as [artist subscriptions](../artists/subscriptions.md), but are associated with your music industry profile rather than an individual artist. 1. You create one or more member subscription tiers 2. Users on Bandruption can subscribe for recurring monthly billing via PayPal 3. Subscribers gain access to members-only content and can be granted priority or exclusive access to your events ## Creating a Subscription Tier From your industry admin panel, go to **Subscriptions β†’ Create Tier**. ### Fields you can configure | Field | Description | |-------|-------------| | **Name** | Tier name (e.g. "Industry Insider", "Pro Member") | | **Description** | What this tier includes | | **Price** | Monthly price in your selected currency | | **Features list** | Bullet-point list of perks shown on the tier card | | **Image** | Optional tier artwork | | **Free trial** | Optional free trial period for new subscribers | | **Published** | Toggle visibility to the public | ## Subscription-Gated Events You can restrict access to specific events to subscribers of certain tiers. See [Ticketing β€” Access Control](../ticketing/overview.md#subscription-access-control) for details. ## Members-Only Content Subscribers can access content you mark as exclusive: - πŸ“· **Photos** - 🎬 **Videos** - 🎡 **Audio** - πŸ“₯ **Downloadable files** ## Managing Subscribers Your admin dashboard shows: - Active subscriber list with subscription details - Next billing dates - Subscriber tier breakdown --- ## Purchasing Tickets Source HTML: https://docs.bandruption.fun/docs/ticketing/purchasing-tickets Markdown alternate: https://docs.bandruption.fun/markdown/docs/ticketing/purchasing-tickets.md # Purchasing Tickets Fans can discover and purchase tickets to events directly from an artist's or music industry profile on [bandruption.fun](https://bandruption.fun). ## Finding Events Events appear on the artist or industry profile page under the **Events** tab. Upcoming events are shown first, sorted by date. ## Buying a Ticket 1. Click on an event to open the event page 2. Browse the available ticket types 3. Select the quantity you want (subject to per-user limits) 4. Click **Purchase** (or **RSVP** for free tickets) 5. Complete payment via PayPal (for paid tickets) 6. Receive a unique ticket code and confirmation ## Member Pricing If you hold an active subscription to the artist or industry profile, discounted member prices are shown automatically. No coupon code is needed. ## Ticket Codes After a successful purchase or RSVP, you receive: - A **unique ticket code** (alphanumeric) for each ticket - A confirmation viewable in your **My Tickets** section - Your ticket displayed as a digital ticket card ## Viewing Your Tickets Go to your user profile and select **My Tickets** to view all your tickets across all events. Each ticket shows: - Event name, date, and location (or virtual link) - Ticket type and quantity - Your unique ticket code - Ticket artwork ## Access Requirements Some events require an active subscription to purchase tickets. If you don't have the required subscription: 1. You will see a prompt explaining which tier is needed 2. Click the subscription prompt to subscribe 3. After subscribing, return to the event to complete your purchase ## Ticket Limits Each ticket type may have a maximum per-user quantity. If you have already reached the limit for a ticket type, the purchase option will be unavailable for that type. ## Cancellations If an event is cancelled, it will be marked as cancelled on the event page. Contact the artist or industry profile directly for refund inquiries.