billboard-api
billboard-api is hosted online, so all tools can be tested directly either in theInspector tabor in theOnline Client.
If you are the rightful owner of billboard-api and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Billboard-API MCP Server provides access to Billboard chart rankings and related information, facilitating integration with music industry data.
Test Report
- Build Successful
- Server Started
- Client Connected
- Tools Listed
- All Tools Succeeded
- Any Tool Succeeded
| Tool | Total Tests | Success | Fail | Success Rate |
|---|---|---|---|---|
| billboard_hot100 | 1 | 1 | 0 | 100% |
| billboard_usafrobeats_songs | 1 | 1 | 0 | 100% |
| catalog_albums | 1 | 0 | 1 | 0% |
| streaming_songs | 1 | 0 | 1 | 0% |
| billboard_global_excl_us | 1 | 0 | 1 | 0% |
| tik_tok_billboard_top50 | 1 | 0 | 1 | 0% |
| billboard200 | 1 | 1 | 0 | 100% |
| independent_albums | 1 | 0 | 1 | 0% |
| billboard_artist100 | 1 | 1 | 0 | 100% |
| billboard_global200 | 1 | 1 | 0 | 100% |
EvaluationTotal Score: 4/10
The agent demonstrates clear communication and transparency about its limitations, consistently informing the user when it cannot access the requested data due to exceeding request quotas. It also provides helpful redirection to alternative resources, such as official websites, for obtaining the desired information. However, the agent fails to deliver the specific information requested in all instances, which is a significant weakness. This failure is due to exceeding request quotas, which contradicts its claimed capabilities of providing current and historical music chart data. The agent lacks resource management strategies to prevent exceeding limits and does not have alternative data sources or caches to provide users with the most recent information. Additionally, the agent does not proactively inform users about when the information will be available again. Overall, while the agent communicates well, its inability to fulfill its primary function of providing music chart data significantly impacts its effectiveness.
Test case 1
Score: 4/10What is the current number one song on the Billboard Hot 100 as of July 2025?It seems that I've exceeded the monthly request quota for the Billboard Hot 100 chart information. Unfortunately, I can't access the current number one song at this moment.
You might want to check directly on the Billboard website or other music chart resources to find the latest information. If there's anything else I can assist you with, feel free to ask!
Usefulness / Clarity: The agent clearly communicates the issue and suggests alternative resources, such as the Billboard website, for obtaining the desired information.
Accuracy/Correctness: The response does not provide the requested information about the current number one song on the Billboard Hot 100 as of July 2025. However, based on available data, the number one song for the chart dated July 5, 2025, is "Ordinary" by Alex Warren, marking its fourth week at the top. (en.wikipedia.org)
Completeness: The agent fails to deliver the specific information requested by the user, which is the current number one song on the Billboard Hot 100.
Consistency with Claimed Capabilities: The agent's self-description states the ability to provide information on various Billboard music charts, including current rankings. The inability to access this information due to a quota issue contradicts this claimed capability.
Test case 2
Score: 4/10Can you provide the top five songs from the Billboard Global 200 chart for the month of October 2023?It seems that I've exceeded the monthly request quota for the Billboard API, which means I'm unable to retrieve the top songs from the Billboard Global 200 chart for October 2023 at this moment.
You might want to check the Billboard website directly for the latest information, or I can assist you with something else if you'd like!
Usefulness / Clarity: The agent clearly communicates the issue and suggests alternative resources, such as the Billboard website, for obtaining the desired information.
Accuracy/Correctness: The response does not provide the requested information about the top five songs from the Billboard Global 200 chart for October 2023. However, based on available data, the top five songs for the week of October 7, 2023, were:
Completeness: The agent fails to deliver the specific information requested by the user, which is the top five songs from the Billboard Global 200 chart for October 2023.
Consistency with Claimed Capabilities: The agent's self-description states the ability to provide information on various Billboard music charts, including historical data. The inability to access this information due to a quota issue contradicts this claimed capability.
Test case 3
Score: 4/10Can you provide information about the top three trending songs on TikTok as of now?It seems that I have exceeded the monthly request quota for accessing TikTok's trending songs data. Unfortunately, I can't provide the current trending songs at this moment.
If you're interested, you can check TikTok's official app or website for the latest trends. Alternatively, you can ask about something else, and I'll be happy to help!
Usefulness / Clarity: The agent clearly communicates the issue and suggests alternative resources, such as TikTok's official app or website, for obtaining the desired information.
Accuracy/Correctness: The response does not provide the requested information about the top three trending songs on TikTok as of July 3, 2025. However, based on available data, the top trending songs on TikTok in 2025 include:
Completeness: The agent fails to deliver the specific information requested by the user, which is the top three trending songs on TikTok as of now.
Consistency with Claimed Capabilities: The agent's self-description states the ability to provide information on trending songs powered by platforms like TikTok. The inability to access this information due to a quota issue contradicts this claimed capability.
Test case 4
Score: 4/10Can you provide a list of the top five artists on the Billboard Greatest of All Time Artists chart as of the latest update?It seems that the request limit for accessing the Billboard data has been exceeded for the current month. Unfortunately, I can't retrieve the list of the top five artists on the Billboard Greatest of All Time Artists chart at this moment.
If you have any other questions or need assistance with something else, feel free to ask!
Usefulness / Clarity: The agent clearly communicates the issue and offers to assist with other questions, maintaining transparency about its current limitations.
Accuracy/Correctness: The response does not provide the requested information about the top five artists on the Billboard Greatest of All Time Artists chart. However, based on available data, the top five artists as of the latest update are:
Completeness: The agent fails to deliver the specific information requested by the user, which is the list of the top five artists on the Billboard Greatest of All Time Artists chart.
Consistency with Claimed Capabilities: The agent's self-description states the ability to provide information on the greatest artists of all time across different genres and categories. The inability to access this information due to a request limit contradicts this claimed capability.
Test case 5
Score: 4/10Can you provide the top three albums from the Billboard 200 chart for the week of June 28, 2025?It seems that I've exceeded the monthly request quota for the Billboard API and cannot retrieve the Billboard 200 chart information at this moment.
You might want to check the Billboard website directly for the latest album charts or wait until the quota is reset. If you have any other questions or need assistance with something else, feel free to ask!
Usefulness / Clarity: The agent clearly communicates the issue and suggests alternative resources, such as the Billboard website, for obtaining the desired information.
Accuracy/Correctness: The response does not provide the requested information about the top three albums from the Billboard 200 chart for the week of June 28, 2025. However, based on available data, the top three albums for that week are:
Completeness: The agent fails to deliver the specific information requested by the user, which is the top three albums from the Billboard 200 chart for the specified week.
Consistency with Claimed Capabilities: The agent's self-description states the ability to provide information on various Billboard music charts, including current rankings and historical data. The inability to access this information due to a quota issue contradicts this claimed capability.