DistroKid API and MCP server Let your AI agent read your DistroKid Bank.

ToolWhat it doesAccess

• get_earnings_summary Earnings totals from the Bank page, grouped by artist, song or service. read

  Returns one row per group with earnings and quantity (streams or downloads, depending on the service). Streaming services report every 1 to 2 months and cover streams from a few months earlier, so recent months can be empty. Amounts are the Bank totals as the page shows them. It reads totals only and never starts a withdrawal.

  MCP calldistrokid_read → get_earnings_summary

  REST endpointGET https://cotlet.dev/api/v1/distrokid/earnings-summary

  Parameters

  Parameters: get_earnings_summary

  Name	Type	Description
  group_by string required	string	artist, song or service.
  from string	string	Start of the period, YYYY-MM-DD.
  to string	string	End of the period, YYYY-MM-DD.

  Example input

  {
    "group_by": "group by"
  }

  Example response

  {
    "group_by": "service",
    "currency": "USD",
    "rows": [
      {
        "service": "Spotify",
        "earnings": 412.6,
        "quantity": 128400
      },
      {
        "service": "Apple Music",
        "earnings": 188.2,
        "quantity": 24100
      }
    ],
    "total_earnings": 600.8
  }

• list_earnings_rows List the detail rows behind the Bank totals, as under "See excruciating detail". read

  Returns the rows of the detail view with the QUANTITY column, one page at a time with next_cursor. DistroKid builds large reports (over 50,000 records) as files that stay available for 7 days, so a wide period can take longer than a narrow one. Use filters to keep reads small.

  MCP calldistrokid_read → list_earnings_rows

  REST endpointGET https://cotlet.dev/api/v1/distrokid/earnings-rows

  Parameters

  Parameters: list_earnings_rows

  Name	Type	Description
  from string	string	Start of the period, YYYY-MM-DD.
  to string	string	End of the period, YYYY-MM-DD.
  store string	string	Filter by store name as the Bank shows it.
  release_id string	string	Filter by release id from list_releases.
  cursor string	string	next_cursor from the previous page.

  Example response

  {
    "rows": [
      {
        "sale_month": "2026-08",
        "store": "Spotify",
        "title": "Night Drive",
        "quantity": 61200,
        "earnings": 198.4
      },
      {
        "sale_month": "2026-08",
        "store": "Apple Music",
        "title": "Night Drive",
        "quantity": 9800,
        "earnings": 76.1
      }
    ],
    "next_cursor": null
  }

• get_daily_stats Estimated daily streams and sales for the last days, from the Stats page. read

  Returns one row per day with estimates from Spotify, Apple Music, iTunes and Amazon. Services update them about every 24 hours for the previous day, and they often differ from the Bank earnings. Numbers can drop to zero for a day when a service reports late. Needs the Musician Plus or Ultimate plan; on Musician the call fails with APP_PERMISSION_DENIED.

  MCP calldistrokid_read → get_daily_stats

  REST endpointGET https://cotlet.dev/api/v1/distrokid/daily-stats

  Parameters

  Parameters: get_daily_stats

  Name	Type	Description
  from string	string	Start date, YYYY-MM-DD.
  to string	string	End date, YYYY-MM-DD.

  Example response

  {
    "days": [
      {
        "date": "2026-10-26",
        "spotify": 1840,
        "apple_music": 220,
        "itunes": 3,
        "amazon": 41
      },
      {
        "date": "2026-10-27",
        "spotify": 1910,
        "apple_music": 205,
        "itunes": 1,
        "amazon": 38
      }
    ]
  }

• get_hyperfollow_stats Visitors and followers added by the HyperFollow page of a release. read

  Returns how many people visited the release's HyperFollow page and how many followers it added. DistroKid creates a HyperFollow page for every upload. Fan email addresses are not returned.

  MCP calldistrokid_read → get_hyperfollow_stats

  REST endpointGET https://cotlet.dev/api/v1/distrokid/releases/{release_id}/hyperfollow-stats

  Parameters

  Parameters: get_hyperfollow_stats

  Name	Type	Description
  release_id string required	string	Release id from list_releases.

  Example input

  {
    "release_id": "release_8c41d2"
  }

  Example response

  {
    "release_id": "r_8f3a21",
    "visitors": 1520,
    "followers_added": 214
  }

ToolWhat it doesAccess

• list_releases List the releases on the account, as on the MyMusic page, with their delivery status. read

  Returns title, artist, release date and status for each release, newest first, one page at a time with next_cursor. The status mirrors the colored circle left of the artwork on MyMusic: green is delivered to services, yellow is still processing or being delivered, red is an error that blocks delivery. Release review, approval and delivery can take several days, so yellow is normal for a new upload.

  MCP calldistrokid_read → list_releases

  REST endpointGET https://cotlet.dev/api/v1/distrokid/releases

  Parameters

  Parameters: list_releases

  Name	Type	Description
  status string	string	Filter by the status circle: delivered (green), processing (yellow), error (red). Omit for all.
  cursor string	string	next_cursor from the previous page.

  Example response

  {
    "releases": [
      {
        "release_id": "r_8f3a21",
        "title": "Night Drive",
        "artist": "Mara Quill",
        "release_date": "2026-09-12",
        "status": "delivered"
      },
      {
        "release_id": "r_71c0be",
        "title": "Low Tide EP",
        "artist": "Mara Quill",
        "release_date": "2026-10-24",
        "status": "processing"
      }
    ],
    "next_cursor": null
  }

• get_release Get one release: tracks, label, release date, status and whether an edit request is pending. read

  Returns the fields the Edit Release page shows and the status circle. DistroKid allows one edit request at a time, so edit_pending tells you whether a new one can be submitted. Track order, release language, Album Extras, genres and ISRCs are locked after upload.

  MCP calldistrokid_read → get_release

  REST endpointGET https://cotlet.dev/api/v1/distrokid/releases/{release_id}

  Parameters

  Parameters: get_release

  Name	Type	Description
  release_id string required	string	Release id from list_releases.

  Example input

  {
    "release_id": "release_8c41d2"
  }

  Example response

  {
    "release_id": "r_71c0be",
    "title": "Low Tide EP",
    "artist": "Mara Quill",
    "label": "Mara Quill",
    "release_date": "2026-10-24",
    "status": "processing",
    "edit_pending": false,
    "tracks": [
      {
        "position": 1,
        "title": "Low Tide"
      },
      {
        "position": 2,
        "title": "Salt Lines"
      }
    ]
  }

• edit_release Submit an edit request for a release, as with Edit Release and Submit Edit Request. writeasks first

  Submits one edit request. Once submitted, DistroKid cannot speed it up or cancel it, and you cannot submit another until it is approved. Most services apply edits within a few days, some take 1 to 2 weeks. Track order, release language, Album Extras, genres and ISRCs cannot be edited. By default you confirm each call; you can switch that off for this tool.

  MCP calldistrokid_write → edit_release

  REST endpointPATCH https://cotlet.dev/api/v1/distrokid/releases/{release_id}

  Parameters

  Parameters: edit_release

  Name	Type	Description
  release_id string required	string	Release id from list_releases.
  changes object required	object	Fields to change, as named on the Edit Release page, for example {"label": "Harbor Lane Records"}.

  Example input

  {
    "release_id": "release_8c41d2",
    "changes": "changes"
  }

  Example response

  {
    "release_id": "r_71c0be",
    "status": "edit_requested",
    "changes": {
      "label": "Harbor Lane Records"
    }
  }

• remove_release Remove a release from all stores, as with "Remove this release from all stores". writeasks first

  Starts the removal at the bottom of Edit Release. It takes up to 1 to 2 weeks to disappear everywhere, and a submitted removal cannot be undone. Removal from only some stores or countries goes through DistroKid support, not this tool. By default you confirm each call; you can switch that off for this tool.

  MCP calldistrokid_write → remove_release

  REST endpointDELETE https://cotlet.dev/api/v1/distrokid/releases/{release_id}

  Parameters

  Parameters: remove_release

  Name	Type	Description
  release_id string required	string	Release id from list_releases.

  Example input

  {
    "release_id": "release_8c41d2"
  }

  Example response

  {
    "release_id": "r_71c0be",
    "status": "removal_requested"
  }

ToolWhat it doesAccess

• get_splits Get the collaborators and percentages set on a release. read

  Returns each song with its collaborators, percentage and invitation state. With no Splits set up, 100% belongs to the account owner. Percentages on a song always add up to 100. A collaborator who has not accepted yet is marked pending; DistroKid holds their share until they join.

  MCP calldistrokid_read → get_splits

  REST endpointGET https://cotlet.dev/api/v1/distrokid/releases/{release_id}/splits

  Parameters

  Parameters: get_splits

  Name	Type	Description
  release_id string required	string	Release id from list_releases.

  Example input

  {
    "release_id": "release_8c41d2"
  }

  Example response

  {
    "release_id": "r_8f3a21",
    "songs": [
      {
        "title": "Night Drive",
        "collaborators": [
          {
            "email": "mara@example.com",
            "percent": 100,
            "state": "owner"
          }
        ]
      }
    ]
  }

• set_splits Replace the collaborators and percentages on a song. writeasks first

  Fills in the Splits form and saves it with Review Changes and Save Changes. It invites every new collaborator by email and sends money by percentage from the next earnings on, and any change to an existing Split makes collaborators accept their invitation again. A bad total fails before anything is saved. By default you confirm each call; you can switch that off for this tool.

  MCP calldistrokid_write → set_splits

  REST endpointPUT https://cotlet.dev/api/v1/distrokid/releases/{release_id}/splits

  Parameters

  Parameters: set_splits

  Name	Type	Description
  release_id string required	string	Release id from list_releases.
  song string required	string	Song title as in get_splits.
  collaborators array required	array	List of {email, percent}. Percentages must add up to 100.

  Example input

  {
    "release_id": "r_8f3a21",
    "song": "Night Drive",
    "collaborators": [
      {
        "email": "mara@example.com",
        "percent": 70
      },
      {
        "email": "producer@example.com",
        "percent": 30
      }
    ]
  }

  Example response

  {
    "release_id": "r_8f3a21",
    "song": "Night Drive",
    "status": "saved",
    "collaborators": [
      {
        "email": "mara@example.com",
        "percent": 70,
        "state": "owner"
      },
      {
        "email": "producer@example.com",
        "percent": 30,
        "state": "pending"
      }
    ]
  }