{
  "name": "Beatra",
  "version": "1.0.0",
  "description": "Beatra is a free Discord music bot playing from YouTube, Spotify, SoundCloud, Apple Music and Deezer, with a web dashboard, playlists, audio effects and 30 languages. Premium starts at $1.49/month.",
  "url": "https://beatra.app",
  "iconUrl": "https://beatra.app/logo.png",
  "provider": {
    "organization": "Codeshare Technology Ltd",
    "url": "https://beatra.app"
  },
  "supportedInterfaces": [
    {
      "type": "rest",
      "url": "https://beatra.app/api/stats",
      "transport": "http",
      "description": "Public stats API: global server count, top servers, playback metrics"
    },
    {
      "type": "rest",
      "url": "https://beatra.app/api/shard-status",
      "transport": "http",
      "description": "Bot shard health and uptime status"
    },
    {
      "type": "rest",
      "url": "https://beatra.app/api/music-stats",
      "transport": "http",
      "description": "Global music playback statistics"
    },
    {
      "type": "rest",
      "url": "https://beatra.app/api/music/songs/top",
      "transport": "http",
      "description": "Most-played songs of all time, with play counts and listening time"
    },
    {
      "type": "rest",
      "url": "https://beatra.app/api/music/artists",
      "transport": "http",
      "description": "Most-played artists of all time"
    },
    {
      "type": "mcp",
      "url": "https://beatra.app/api/mcp",
      "transport": "streamable-http",
      "description": "The same reads as MCP tools (JSON-RPC 2.0). Card: /.well-known/mcp/server-card.json"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "skills": [
    {
      "id": "get-stats",
      "name": "Get Bot Statistics",
      "description": "Retrieve global Beatra statistics: active servers, top servers by play count, and monthly active users",
      "endpoint": "https://beatra.app/api/stats",
      "method": "GET",
      "parameters": {
        "type": {
          "type": "string",
          "enum": [
            "global"
          ],
          "default": "global"
        }
      }
    },
    {
      "id": "get-shard-status",
      "name": "Get Shard Status",
      "description": "Retrieve real-time status of all Beatra bot shards including uptime, guild counts, and latency",
      "endpoint": "https://beatra.app/api/shard-status",
      "method": "GET"
    },
    {
      "id": "get-music-stats",
      "name": "Get Music Statistics",
      "description": "Retrieve global music playback statistics and trending information",
      "endpoint": "https://beatra.app/api/music-stats",
      "method": "GET"
    },
    {
      "id": "get-top-songs",
      "name": "Get Top Songs",
      "description": "The most-played songs on Beatra of all time, with play counts and listening time",
      "endpoint": "https://beatra.app/api/music/songs/top",
      "method": "GET",
      "parameters": {
        "sort": {
          "type": "string",
          "enum": [
            "weighted",
            "plays",
            "listens"
          ],
          "default": "weighted"
        },
        "limit": {
          "type": "integer",
          "default": 24
        }
      }
    },
    {
      "id": "search-songs",
      "name": "Search Songs",
      "description": "Search the songs Beatra has played, by title or artist",
      "endpoint": "https://beatra.app/api/music/songs/search",
      "method": "GET",
      "parameters": {
        "q": {
          "type": "string"
        },
        "limit": {
          "type": "integer",
          "default": 8
        }
      }
    },
    {
      "id": "get-top-artists",
      "name": "Get Top Artists",
      "description": "The most-played artists on Beatra of all time",
      "endpoint": "https://beatra.app/api/music/artists",
      "method": "GET",
      "parameters": {
        "sort": {
          "type": "string",
          "enum": [
            "plays",
            "listens"
          ],
          "default": "plays"
        },
        "limit": {
          "type": "integer",
          "default": 24
        }
      }
    }
  ],
  "contact": {
    "support": "https://discord.gg/ACJQzJuckW",
    "invite": "https://discord.com/oauth2/authorize?client_id=774043716797071371&permissions=8&scope=bot%20applications.commands"
  }
}