VibeTide MCP Server

Instructions

Args:
    encoded_level: An encoded level string for playing

Returns a URL to play the level.

Implementation Reference

• vibe_tide_mcp_server.py:694-727 (handler)

  The primary handler for the 'play_level' tool. Decorated with @mcp.tool() for automatic registration in FastMCP. Decodes the encoded_level to extract the level name and constructs the play URL using the configured web player base URL. Includes schema definition in the docstring for input (encoded_level: str) and output structure.

  @mcp.tool()
  async def play_level(encoded_level: str) -> Dict[str, Any]:
      """Get the URL to play a VibeTide level in the web player.
  
      Args:
          encoded_level: An encoded level string for playing
  
      Returns a URL to play the level.
      """
      try:
          # Decode level to get name
          try:
              level_data = level_encoder.decode(encoded_level)
              level_name = level_data.get("name", "Unnamed Level")
          except Exception as e:
              return {"success": False, "error": f"Invalid encoded level: {str(e)}"}
  
          play_url = f"{VIBE_TIDE_CONFIG['web_player_url']}?level={encoded_level}"
  
          return {
              "success": True,
              "play_url": play_url,
              "level_name": level_name,
              "web_player_url": VIBE_TIDE_CONFIG["web_player_url"],
              "message": f"Ready to play '{level_name}' at: {play_url}",
          }
  
      except Exception as e:
          logger.error(f"Failed to prepare level for playing: {e}")
          return {
              "success": False,
              "error": f"Failed to prepare level for playing: {str(e)}",
          }